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What will you learn from this book? 

Head First java is a complete learning experience in Java and objeci- 
oriented programming. This book helps you learn the Java language 
with a unique method that goes beyond syntax and how-to manuals 
and helps you understand how to he a great programmer. Ynu ll 
learn language fundamentals, generics, threading, networking, 
and distributed programming, and you’ll even build a “sink the dot 
com” game and networked drum machine chat client along the way. 
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What’s so special about this book? 

We ill ink yuur lime is too valuable to unsle struggling with new con¬ 
cepts, Using the latest research in cogniti'e science and learning 
theory to craft a multi-sensnry learning experience, Head First java 
uses a visually rich format designed for the way your brain works, not 
a text-heavy approach that puts you to sleep. 
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“… The only way to 
decide the worth of a 
tutorial is to decide 
how well it taaclieB. 
Head First Java excels 

at teaching/ 9 

—— slashdoiMrg 

‘‘… It’s definitely time to 
dive in—Head First: 

~Scott McNealy, Sun 
Microsystems. CJiairman ， 
President，and CEO 

a Head First Jav^a trans¬ 
forms the printed page 
into the closest thing 
to a GUI you’ve ever 
seen. In a wry, hip 
manner, the authors 
make learning Java 
an engaging, 'what're 
they gonna do next?’ 

experience," 

—— Warren Keuffel, 
S oft ware D e velop me nt 

Magazine 

“It’s fast, irreverent, 
fun, and engaging. 

Be careful — you might 
actually learn some¬ 
thing!^ 

—— Ken Arnold, coauthor 
(with fames Gosling, 
erm lor of java), The J ava 
Program m i ng Language 









































What they’re saying about Head First 



Amazon named Head First Java 
a Top Ten Editor’s Choice for 
Computer Books of 2003 
(first edition) 
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Software Development Magazine named 
Head First Java a finalist for the 14th Annual 
Jolt Cola/Product Excellence Awards 


“Kathy and Bert’s 'Head First Java 5 transforms the printed page into the closest thing to a GUI you’ve 
ever seen. In a wry, hip manner, the authors make learning Java an engaging ‘what’re they gonna do 
next? 5 experience.” 

— Warren Keuffel, Software Development Magazine 


“...the only way to decide the worth of a tutorial is to decide how well it teaches. Head First Java excels at 
teaching. OK, I thought it was silly... then I realized that I was thoroughly learning the topics as I went 
through the book.” 

“The style of Head First Java made learning, well, easier.” 

— slashdot (honestpuck’s review) 

“Beyond the engaging style that drags you forward from know-nothing into exalted Java warrior status, 

Head First Java covers a huge amount of practical matters that other texts leave as the dreaded “exercise 
for the reader".” It’s clever, wry, hip and practical — there aren’t a lot of textbooks that can make that claim 
and live up to it while also teaching you about object serialization and network launch protocols. ” 

— Dr. Dan Russell, Director of User Sciences and Experience Research 

IBM Almaden Research Center (and teaches Artificial Intelligence at Stanford University) 


“It’s fast, irreverent, fun, and engaging. Be careful ― you might actually learn something!” 

— Ken Arnold, former Senior Engineer at Sun Microsystems 

Co-author (with James Gosling, creator of Java), “The Java Programming Language” 


‘Java technology is everywhere — If you develop software and haven’t learned Java, it’s definitely 
time to dive in — Head First.” 

— Scott McNealy, Sun Microsystems Chairman, President and CEO 


“Head First Java is like Monty Python meets the gang of four... the text is broken up so well by puzzles 
and stories, quizzes and examples, that you cover ground like no computer book before.” 

— Douglas Rowe, Columbia Java Users Group 



Praise for Head First Java 


“Read Head First Java and you will once again experience fun in learning...For people who like to learn 
new programming languages, and do not come from a computer science or programming background, 
this book is a gem... This is one book that makes learning a complex computer language fun. I hope 
that there are more authors who are willing to break out of the same old mold of ‘traditional’ writing 
styles. Learning computer languages should be fun, not onerous.” 

— Judith Taylor, Southeast Ohio Macromedia User Group 


“If you want to /mmJava，look no further: welcome to the first GUI-based technical book! This 
perfectly-executed, ground-breaking format delivers benefits other Java texts simply can’t... 

Prepare yourself for a truly remarkable ride through Java land.” 

— Neil R. Bauman, Captain 8c CEO, Geek Cruises (www.GeekCruises.com) 

“If you’re relatively new to programming and you are interested in Java, here’s your book... Cove ring 
everything from objects to creating graphical user interfaces (GUI), exception (error) handling to net¬ 
working (sockets) and multithreading, even packaging up your pile of classes into one installation file ， 
this book is quite complete...If you like the style".I’m certain you’ll love the book and, like me, hope 
that the Head First series will expand to many other subjects!” 

— LinuxQuestions.org 

“I was ADDICTED to the book’s short stories, annotated code, mock interviews, and brain exercises.” 

— Michael Yuan, author, Enterprise J2ME 

“ ‘Head First Java’ … gives new meaning to their marketing phrase 、 There’s an O Reilly for that." I 
picked this up because several others I respect had described it in terms like ‘revolutionary’ and a 
described a radically different approach to the textbook. They were (are) right... In typical O’Reilly 
fashion, they’ve taken a scientific and well considered approach. The result is funny, irreverent, topical, 
interactive, and brilliant...Reading this book is like sitting in the speakers lounge at a view conference, 
learning from - and laughing with - peers... If you want to UNDERSTAND Java, go buy this book.” 

— Andrew Pollack, www.thenorth.com 

“If anyone in the world is familiar with the concept of ‘Head First，’ it would be me. This 
book is so good, I’d marry it on TV!” 

— Rick Rockwell, Comedian 

The original FOX Television “Who Wants to Marry a Millionaire” groom 

“This stuff is so fricking good it makes me wanna WEEP! I’m stunned.” 

— Floyd Jones, Senior Technical Writer/Poolboy, BEA 

“A few days ago I received my copy of Head First Java by Kathy Sierra and Bert Bates. I’m only part way 
through the book, but what’s amazed me is that even in my sleep-deprived state that first evening, I found 
myself thinking, 4 OK, just one more page, then I’ll go to bed.’ “ 

— Joe Litton 


Praise for other Head First books co-authored by Kathy and Bert 


Amazon named Head First Servlets 
a Top Ten Editor’s Choice for 
Computer Books of 2004 
(first edition) 
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Software Development Magazine named 
Head First Servlets and Head First Design 
Patterns finalists for the 15th Annual 
Product Excellence Awards 


“I feel like a thousand pounds of books have just been lifted off of my head.” 

— Ward Cunningham, inventor of the Wiki 
and founder of the Hillside Group 

“I laughed, I cried, it moved me.” 

— Dan Steinberg, Editor-in-Chief ， java.net 

“My first reaction was to roll on the floor laughing. After I picked myself up, I realized that not only is the 
book technically accurate, it is the easiest to understand introduction to design patterns that I have seen.” 

— Dr. Timothy A. Budd，Associate Professor of Computer Science at Oregon State University 
author of more than a dozen books including C++for Java Programmers 

“Just the right tone for the geeked-out, casual-cool gum coder in all of us. The right reference for prac¬ 
tical development strategies — gets my brain going without having to slog through a bunch of tired 
stale professor-speak.” 

— Travis Kalanick, Founder of Scour and Red Swoosh 
Member of the MIT TR100 


“FINALLY _ a Java book written the way I would’a wrote it if I were me. 

Seriously though - this book absolutely blows away every other software book I’ve ever read... 

A good book is very difficult to write... you have to take a lot of time to make things unfold in a 
natural, “reader oriented” sequence. It’s a lot of work. Most authors clearly aren’t up to the challenge. 
Congratulations to the Head First EJB team for a first class job! 

— Wally Flint 

“I could not have imagined a person smiling while studying an IT book! Using Head First EJB 
materials, I got a great score (91%) and set a world record as the youngest SCBCD，14 years.” 

— Afsah Shafquat (world’s youngest SCBCD) 


“This Head First Servlets book is as good as the Head First EJB book, which made me laugh 
AND gave me 97% on the exam!” 

— Jef Cumps, J2EE consultant, Cronos 
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Extension’s Entertainment Studies program. 
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Microsystems, teaching Sun’s Java instructors how 
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concepts in Head First Java to teach hundreds of 
trainers, developers and even non-programmers. 
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Intro 

Your brain on J3V3. Here you are trying to learn something, while here your brain 
is doing you a favor by making sure the learning doesn’t stick. Your brain’s thinking,"Better 
leave room for more important things, like which wild animals to avoid and whether naked 
snowboarding is a bad idea.” So how do you trick your brain into thinking that your life 
depends on knowing Java? 


Who is this book for? 

What your brain is thinking 
Metacognition 

Bend your brain into submission 
What you need for this book 
Technical editors 
Acknowledgements 


xxii 

xxiii 

XXV 

xxvii 

xxviii 

XXX 


XXXI 


ix 




Breaking the Surface 

Java takes you to new places. From its humble release to the public as the 
(wimpy) version 1.02, Java seduced programmers with its friendly syntax, object-oriented 
features, memory management, and best of all — the promise of portability. We'll take a quick 
dip and write some code, compile it, and run it. We’re talking syntax, loops, branching, and what 
makes Java so cool. Dive in. 
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The way Java works 
Code structure in Java 
Anatomy of a class 
The main() method 
Looping 

Conditional branching [if tests) 
Coding the “99 bottles of beer” app 
Phrase-o-matic 

Fireside chat: compiler vs. JVM 
Exercises and puzzles 
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A Trip to Objectville 

I was told there would be objects. In Chapter 1, we put all of our code 
in the main() method. That’s not exactly object-oriented. So now we’ve got to leave that 
procedural world behind and start making some objects of our own. We’ll look at what 
makes object-oriented (00) development in Java so much fun. We’ll look at the difference 
between a class and an object. We’ll look at how objects can improve your life. 
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Chair Wars (Brad the OO guy vs. Larry the procedural guy) 
Inheritance (an introduction) 

Overriding methods (an introduction) 

What’s in a class? (methods, instance variables) 

Making your first object 
Using main() 
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Exercises and puzzles 
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Know Your Variables 

Variables come in two flavors: primitive and reference. 

There’s gotta be more to life than integers, Strings, and arrays. What if you have a PetOwner 
object with a Dog instance variable? Or a Car with an Engine? In this chapter we’ll unwrap 
the mysteries of Java types and look at what you can declare as a variable, what you can put 
in a variable, and what you can do with a variable. And we’ll finally see what life is truly like 
on the garbage-collectible heap. 



Dog reference 


Declaring a variable (Java cares about type) 50 

Primitive types (“I’d like a double with extra foam, please ”） 51 

Java keywords 53 

Reference variables (remote control to an object) 54 

Object declaration and assignment 55 

Objects on the garbage-collectible heap 57 

Arrays (a first look) 59 

Exercises and puzzles 63 
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w Objects Behave 


te affects behavior, behavior affects state. We know that objects 

e state and behavior, represented by instance variables and methods. Now we’ll look 


at how state and behavior are related. An object's behavior uses an object's unique state. 
In other words, methods use instance variable values. Like,"if dog weight is less than 14 
pounds, make yippy sound, else..." Let’s go change some state! 



pass-by-value means 
pass-by-copy 


int int 

foo.go (x); void go (int z) { } 


Methods use object state (bark different) 
Method arguments and return types 
Pass-by-value (the variable is always copied) 
Getters and Setters 

Encapsulation (do it or risk humiliation) 
Using references in an array 
Exercises and puzzles 
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Extra-Strength Methods 


Let’s put some muscle in our methods. You dabbled with variables, 

played with a few objects, and wrote a little code. But you need more tools. Like 
operators. And loops. Might be useful to generate random numbers. And turn 
a String into an int, yeah, that would be cool. And why don’t we learn it all by building 
something real, to see what it’s like to write (and test) a program from scratch. Maybe a 
game, like Sink a Dot Com (similar to Battleship). 
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Building the Sink a Dot Com game 

Starting with the Simple Dot Com game (a simpler version) 
Writing prepcode (pseudocode for the game) 

Test code for Simple Dot Com 

Coding the Simple Dot Com game 

Final code for Simple Dot Com 

Generating random numbers with Math.random() 

Ready-bake code for getting user input from the command-line 
Looping with for loops 
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Using the Java Library 

Java ships with hundreds of pre-built classes. You don’t have to 

reinvent the wheel if you know how to find what you need from the Java library, commonly 
known as the Java API. You've got better things to do. If you’re going to write code, you 


might as well write only the parts that are custom for your application.The core Java library 
is a giant pile of classes just waiting for you to use like building blocks. 


“Good to know there’s an ArrayList in 
the java, util package. But by myself, how 
would I have figured that out?” 


Julia, 31, hand model 



Analying the bug in the Simple Dot Com Game 
ArrayList (taking advantage of the Java API) 

Fixing the DotGom class code 
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Prepcode for the real game 
Code for the real game 
boolean expressions 
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Better Living in Objectville 

/ Plan your programs with the future in mind. What if you could write 

code that someone else could extend, easily? What if you could write code that was flexible, 
for those pesky last-minute spec changes? When you get on the Polymorphism Plan, you’ll 
learn the 5 steps to better class design, the 3 tricks to polymorphism, the 8 ways to make 

ou act now — a bonus lesson on the 4 tips for exploiting inheritance. 
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Understanding inheritance (superclass and subclass relationships) 168 

Designing an inheritance tree (the Animal simulation) 170 

Avoiding duplicate code (using inheritance) 171 

Overriding methods 172 

IS-A and HAS-A (bathtub girl) 177 

What do you inherit from your superclass? 180 

What does inheritance really buy you? 182 

Polymorphism (using a supertype reference to a subclass object) 183 

Rules for overriding (don’t touch those arguments and return types!) 190 
Method overloading (nothing more than method name re-use) 191 

Exercises and puzzles 192 



Serious Polymorphism 

Inheritance is just the beginning. To exploit polymorphism, we need 
interfaces. We need to go beyond simple inheritance to flexibility you can get only by 
designing and coding to interfaces. What’s an interface? A 1 00% abstract class. What’s an 
abstract class? A class that can’t be instantiated. What’s that good for? Read the chapter... 



Object o = al.get(id); 
Dog d = (Dog) o; 


d • bark(); 


f hc 


Object 


Some classes just should not be instantiated 
Abstract classes [can’t be instantiated) 

Abstract methods (must be implemented) 

Polymorphism in action 

Glass Object (the ultimate superclass of everything) 

Taking objects out of an Array List (they come out as 
Compiler checks the reference type (before letting you call a method) 
Get in touch with your inner object 
Polymorphic references 

Casting an object reference (moving lower on the inheritance tree) 
Deadly Diamond of Death (multiple inheritance problem) 

Using interfaces (the best solution!) 

Exercises and puzzles 
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Life and Death of an Object 

bjects are born and objects die. You’re in charge. You decide when and 
ow to construct them. You decide when to abandon them. The Garbage Collector (gc) 
reclaims the memory. We'll look at how objects are created, where they live, and how to 
keep or abandon them efficiently.That means we’ll talk about the heap, the stack, scope, 
constructors, super constructors, null references, and gc eligibility. 
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The stack and the heap, where objects and variables live 

Methods on the stack 

Where local variables live 

Where instance variables live 

The miracle of object creation 

Constructors (the code that runs when you say new) 

Initializing the state of a new Duck 

Overloaded constructors 

Superclass constructors (constructor chaining) 

Invoking overloaded constructors using this() 

Life of an object 

Garbage Collection (and making objects eligible) 
Exercises and puzzles 
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Static variables 


Numbers Matter 

Do the Math .The Java API has methods for absolute value, rounding, min/max, etc. 
But what about formatting? You might want numbers to print exactly two decimal points. 


are shared by 


or with commas in all the right places. And you might want to print and manipulate dates. 


all instances of 
a class. 


too. And what about parsing a String into a number? Or turning a number into a String? 
We’ll start by learning what it means for a variable or method to be static. 
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Math class (do you really need an instance of it?) 274 
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Number formatting 294 
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Risky Behavior 

Stuff happens. The file isn’t there.The server is down. No matter how good a 
programmer you are, you can't control everything. When you write a risky method, you need 
code to handle the bad things that might happen. But how do you /enow when a method is 
risky? Where do you put the code to handle the excepf/ona/ situation? In this chapter, we’re 
going to build a MIDI Music Player, that uses the risky JavaSound API, so we better find out. 



Making a music machine (the BeatBox) 

What if you need to call risky code? 

Exceptions say “something bad may have happened...” 

The compiler guarantees (it checks) that you’re aware of the risks 
Catching exceptions using a try/catch (skateboarder) 

Flow control in try/catch blocks 

The finally block (no matter what happens, turn off the oven!) 
Catching multiple exceptions (the order matters) 

Declaring an exception (just duck it) 

Handle or declare law 
Code Kitchen (making sounds) 

Exercises and puzzles 
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A Very Graphic Story 

Face it, you need to make GUIs. Even if you believe that for the rest of your 
life you’ll write only server-side code, sooner or later you’ll need to write tools, and you’ll 
want a graphical interface. We’ll spend two chapters on GUIs, and learn more language 
features including Event Handling and Inner Classes. We’ll put a button on the screen. 


class MyOuter { 

class MyInner { 
void go () { 


The outer and inner objects 
are now intimately linked. 


TV^se W 

a 
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we’ll paint on the screen, we’ll display a jpeg image, and we’ll even do some animation. 



/'nne^ 


Your first GUI 

Getting a user event 

Implement a listener interface 

Getting a button’s ActionEvent 

Putting graphics on a GUI 

Fun with paintComponentQ 

The Graphics2D object 

Putting more than one button on a screen 

Inner classes to the rescue (make your listener an inner class) 

Animation (move it, paint it, move it, paint it, move it, paint it...) 

Code Kitchen (painting graphics with the beat of the music) 


355 

357 

358 
360 
363 

365 

366 
370 
376 
382 
386 


Exercises and puzzles 


394 


XV 
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Work on your Swing 

Swing is easy. Unless you actually core where everything goes. Swing code looks 
easy, but then compile it, run it, look at it and think,"hey, that’s not supposed to go there.” 
The thing that makes it easy to code is the thing that makes it hard to control — the Layout 
Manager. But with a little work, you can get layout managers to submit to your will. In 
this chapter, we’ll work on our Swing and learn more about widgets. 
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Swing Components 

Layout Managers (they control size and placement) 

Three Layout Managers (border, flow, box) 

BorderLayout (cares about five regions) 

FlowLayout (cares about the order and preferred size) 
BoxLayout (like flow, but can stack components vertically) 
JTextField (for single-line user input) 

JTextArea (for multi-line, scrolling text) 

JGheckBox (is it selected?) 

JList (a scrollable, selectable list) 

Code Kitchen (The Big One - building the BeatBox chat client) 
Exercises and puzzles 
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403 

404 
408 
411 

413 

414 

416 

417 

418 
424 
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Saving Objects 

Objects can be flattened and inflated. Objects have state and behavior. 

Behavior lives in the class, but state lives within each individual object. If your program 
needs to save state,you can do it the hard way, interrogating each object, painstakingly 
writing the value of each instance variable. Or, you can do it the easy OO way — you simply 
freeze-dry the object (serialize it) and reconstitute (deserialize) it to get it back. 




(l 





Saving object state 431 

Writing a serialized object to a file 432 

Java input and output streams (connections and chains) 433 

Object serialization 434 

Implementing the Serializable interface 437 

Using transient variables 439 

Deserializing an object 441 

Writing to a text file 447 

java.io.File 452 

Reading from a text file 454 

Splitting a String into tokens with splitO 458 

GodeKitchen 462 

Exercises and puzzles 466 
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Make a Connection 

Connect with the outside world. It’s easy. All the low-level networking 
details are taken care of by classes in the java.net library. One of Java’s best features is 
that sending and receiving data over a network is really just I/O with a slightly different 
connection stream at the end of the chain. In this chapter we'll make client sockets. We’ll 




make server sockets. We’ll make clients and servers. Before the chapter’s done, you’ll have a 
fully-functional, multithreaded chat client. Did we just say multithreaded? 



Client 




Server 




Chat program overview 


473 

Connecting, sending, and receiving 


474 

Network sockets 


475 

TCP ports 


476 

Reading data from a socket (using BufferedReader) 


478 

Writing data to a socket (using PrintWriter) 


479 

Writing the Daily Advice Client program 


480 

Writing a simple server 


483 

Daily Advice Server code 


484 

Writing a chat client 


486 

Multiple call stacks 


490 

Launching a new thread (make it, start it) 


492 

The Runnable interface (the thread’s job) 


494 

Three states of a new Thread object (new, runnable, running) 

495 

The runnable-running loop 


496 

Thread scheduler (it’s his decision, not yours) 


497 

Putting a thread to sleep 


501 

Making and starting two threads 


503 

Concurrency issues: can this couple be saved? 


505 

The Ryan and Monica concurrency problem, in code 


506 

Locking to make things atomic 


510 

Every object has a lock 


511 

The dreaded “Lost Update” problem 


512 

Synchronized methods (using a lock) 


514 

Deadlock! 


516 

Multithreaded ChatGlient code 


518 

Ready-bake SimpleGhatServer 


520 

Exercises and puzzles 


524 


XVII 
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Data Structures 

Sorting is a snap in Java. You have all the tools for collecting and manipulating 
your data without having to write your own sort algorithms The Java Collections 
Framework has a data structure that should work for virtually anything you’ll ever need 
to do. Want to keep a list that you can easily keep adding to? Want to find something by 
name? Want to create a list that automatically takes out all the duplicates? Sort your co¬ 
workers by the number of times they’ve stabbed you in the back? 



Set 


Map 




Collections 

Sorting an ArrayList with Collections.sortO 
Generics and type-safety 

Sorting things that implement the Comparable interface 

Sorting things with a custom Comparator 

The collection API —— lists, sets, and maps 

Avoiding duplicates with HashSet 

Overriding hashCodeO and equalsO 

HashMap 

Using wildcards for polymorphism 
Exercises and puzzles 


533 

534 
540 
547 
552 
557 

559 

560 
567 
574 
576 
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Release Your Code 

It’s time to let go. You wrote your code. You tested your code. You refined your code. 
You told everyone you know that if you never saw a line of code again, that’d be fine. But in 
the end, you’ve created a work of art. The thing actually runs! But now what? In these final 
two chapters, we’ll explore how to organize, package, and deploy your Java code. We’ll look 
at local, semi-local, and remote deployment options including executable jars, Java Web 
Start, RMI, and Servlets. Relax. Some of the coolest things in Java are easier than you think. 


MyApp.jar 


MyApp.class 



JWS 





Deployment options 

582 

Keep your source code and class files separate 

584 

Making an executable JAR Java ARchives) 

585 

Running an executable JAR 

586 

Put your classes in a package! 

587 

Packages must have a matching directory structure 

589 

Compiling and running with packages 

590 

Compiling with -d 

591 

Making an executable JAR (with packages) 

592 

Java Web Start JWS) for deployment from the web 

597 

How to make and deploy a JWS application 

600 

Exercises and puzzles 

601 
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Distributed Computing 


eing remote doesn’t have to be a bad thing. Sure, things are easier 

when all the parts of your application are in one place, in one heap, with one JVM to rule 
them all. But that’s not always possible. Or desirable. What if your application handles 
powerful computations? What if your app needs data from a secure database? In this 


chapter, we’ll learn to use Java’s amazingly simple Remote Method Invocation (RMI). We’ll 
also take a quick peek at Servlets, Enterprise Java Beans (EJB), and Jini. 




Java Remote Method Invocation (RMI), hands-on, very detailed 
Servlets (a quick look) 

Enterprise JavaBeans (EJB), a very quick look 
Jini, the best trick of all 

Building the really cool universal service browser 
The End 
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4 Appendix A 

/ \ The final Code Kitchen project. 

/ 「 ■ \ beat box. Your chance to be a rock star. 
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All the code for the full client-server chat 


BeatBoxFinal (client code) 650 

MusicServer (server code) 657 



Appendix B 

The Top Ten Things that didn’t make it into the book. We can’t send 

you out into the world just yet. We have a few more things for you, but this is the end of the 
book. And this time we really mean it. 


Top Ten List 


660 



Index 


677 
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I cant believe they 
put in a Java 
programming book! 
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how to use this book 


Who is this book for? 

If you can answer “yes” to all of these: 

Have you done some programming? 

( 2 ) Do you want to learn Java? 

(3) Do you prefer stimulating dinner party 
conversation to dry, dull, technical 
lectures? 


This is NOT a reference 
book. Head First Java is a 
book designed for learning ， 
not an encyclopedia of 
Java facts. 


this book is for you. 


Who should probably back away from this book? 


If you can answer “yes” to any one of these: 

^T) Is your programming background limited 
to HTML only, with no scripting language 
experience? 

(If you’ve done anything with looping, or if/then 
logic, you’ll do fine with this book, but HTML 
tagging alone might not be enough.) 

(g) Are you a kick-butt C++ programmer 
looking for a reference book? 


(3) Are you afraid to try something different? 
Would you rather have a root canal than 
mix stripes with plaid? Do you believe 
than a technical book can’t be serious if 
there’s a picture of a duck in the memory 
management section? 

this book is not for you. 



r 抓 3 : “ 十 k 。钍 t — 心 b 。 扎 w 


XXII 



the intro 


Wc know what you're thmkmg. 


‘How can this be a serious Java programming book?” 
‘What’s with all the graphics?” 

‘Can I actually learn it this way?” 

‘Do I smell pizza?” 



And we know what your brain is thmkmg. 

Your brain craves novelty. It’s always searching, scanning, waiting for 
something unusual. It was built that way, and it helps you stay alive. 

Today, you’re less likely to be a tiger snack. But your brain’s still 
looking. You just never know. 

So what does your brain do with all the routine, ordinary, normal 
things you encounter? Everything it can to stop them from 
interfering with the brain’s real job — recording things that matter. It 
doesn’t bother saving the boring things; they never make it past the 
“this is obviously not important” filter. 

How does your brain know what^ important? Suppose you’re out for 
a day hike and a tiger jumps in front of you, what happens inside your 
head? 

Neurons fire. Emotions crank up. Chemicals surge. 

And that’s how your brain knows... 

This must be important! Don’t forget it! 

But imagine you’re at home, or in a library. It’s a safe, warm, tiger-free 
zone. You’re studying. Getting ready for an exam. Or trying to learn 
some tough technical topic your boss thinks will take a week, ten days 
at the most. 


Just one problem. Your brain’s trying to do you a big favor. It’s 
trying to make sure that this obviously non-important content 
doesn’t clutter up scarce resources. Resources that are better 
spent storing the really 吨 things. Like tigers. Like the danger of 
fire. Like how you should never again snowboard in shorts. 

And there’s no simple way to tell your brain, “Hey brain, thank 
you very much, but no matter how dull this book is, and how 
little I’m registering on the emotional richter scale right now, I 
really do want you to keep this stuff around.” 
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the intro 


Metacognition: thinking about thinking. 

If you really want to learn, and you want to learn more quickly and more deeply, 
pay attention to how you pay attention. Think about how you think. Learn how 
you learn. 

Most of us did not take courses on metacognition or learning theory when we were 
growing up. We were expected to learn, but rarely taught to learn. 

But we assume that if you’re holding this book, you want to learn Java. And you 
probably don’t want to spend a lot of time. 

To get the most from this book, or any book or learning experience, take 
responsibility for your brain. Your brain on that content. 

The trick is to get your brain to see the new material you’re learning 
as Really Important. Crucial to your well-being. As important as 
a tiger. Otherwise, you’re in for a constant battle, with your brain 
doing its best to keep the new content from sticking. 


So just how DO you get your brain to treat Java like it 
was a hungry tiger? 

There’s the slow, tedious way, or the faster, more effective way. The 
slow way is about sheer repetition. You obviously know that you are 
able to learn and remember even the dullest of topics, if you keep pounding 
on the same thing. With enough repetition, your brain says, “This do^n\ feel 
important to him, but he keeps looking at the same thing over and over and over, so 
I suppose it must be.” 

The faster way is to do anything that increases brain activity ， especially different types 
of brain activity. The things on the previous page are a big part of the solution, 
and they’re all things that have been proven to help your brain work in your favor. 
For example, studies show that putting words within the pictures they describe (as 
opposed to somewhere else in the page, like a caption or in the body text) causes 
your brain to try to makes sense of how the words and picture relate, and this 
causes more neurons to fire. More neurons firing = more chances for your brain 
to get that this is something worth paying attention to, and possibly recording. 



A conversational style helps because people tend to pay more attention when they 
perceive that they’re in a conversation, since they’re expected to follow along and 
hold up their end. The amazing thing is, your brain doesn’t necessarily care that 
the “conversation” is between you and a book! On the other hand, if the writing 
style is formal and dry, your brain perceives it the same way you experience being 
lectured to while sitting in a roomful of passive attendees. No need to stay awake. 

But pictures and conversational style are just the beginning. 
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how to use this book 


Here's what WE did: 

We used pictures, because your brain is tuned for visuals, not text. As far as your 
brain’s concerned, a picture really is worth 1024 words. And when text and pictures 
work together, we embedded the text in the pictures because your brain works 
more effectively when the text is within the thing the text refers to, as opposed to in 
a caption or buried in the text somewhere. 

We used repetition, saying the same thing in different ways and with different media 
types, and multiple senses, to increase the chance that the content gets coded coded 
into more than one area of your brain. 

We used concepts and pictures in unexpected ways because your brain is tuned for 
novelty, and we used pictures and ideas with at least some emotional content, because 
your brain is tuned to pay attention to the biochemistry of emotions. That which 
causes you to feel something is more likely to be remembered, even if that feeling is 
nothing more than a little humor, surprise, or interest. 

We used a personalized, conversational style, because your brain is tuned to pay more 
attention when it believes you’re in a conversation than if it thinks you’re passively 
listening to a presentation. Your brain does this even when you’re reading. 

We included more than 50 exercises , because your brain is tuned to learn and 
remember more when you do things than when you read about things. And we 
made the exercises challenging-yet-do-able, because that’s what most people prefer. 

We used multiple learning styles, because you might prefer step-by-step procedures, 
while someone else wants to understand the big picture first, while someone else 
just wants to see a code example. But regardless of your own learning preference, 
everyone benefits from seeing the same content represented in multiple ways. 

We include content for both sides of your brain, because the more of your brain you 
engage, the more likely you are to learn and remember, and the longer you can 
stay focused. Since working one side of the brain often means giving the other side 
a chance to rest, you can be more productive at learning for a longer period of 
time. 

And we included stories and exercises that present more than one point of view ， 
because your brain is tuned to learn more deeply when it’s forced to make 
evaluations and judgements. 

We included challenges, with exercises, and by asking questions that don’t always have 
a straight answer, because your brain is tuned to learn and remember when it has 
to work at something (just as you can’t get your body in shape by watching people 
at the gym). But we did our best to make sure that when you’re working hard, it’s 
on the right things. That you^re not spending one extra dendrite processing a hard-to- 
understand example, or parsing difficult, jargon-laden, or extremely terse text. 

We used an 80/20 approach. We assume that if you’re going for a PhD in Java, 
this won’t be your only book. So we don’t talk about everything. Just the stuff you’ll 
actually use. 
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Here's what YOU caw do to bend your 
brain mto submission. 


So, we did our part. The rest is up to you. These tips are a 
starting point; Listen to your brain and figure out what works 
for you and what doesn’t. Try new things. 




on 


the intro 



(T) Slow down. The more you understand, 
the less you have to memorize. 

Don’t just read. Stop and think. When the 
book asks you a question, don’t just skip to 
the answer. Imagine that someone really is 
asking the question. The more deeply you 
force your brain to think, the better chance 
you have of learning and remembering. 

( 5 ) Do the exercises. Write your own notes. 

We put them in, but if we did them for you, 
that would be like having someone else 
do your workouts for you. And don’t just 
look at the exercises. Use a pencil. There’s 
plenty of evidence that physical activity 
while learning can increase the learning. 

(3) Read the “There are No Dumb Questions” 

That means all of them. They’re not 
optional side-bars — they’re part of the core 
content! Sometimes the questions are more 
useful than the answers. 


Drink water. Lots of it. 

Your brain works best in a nice bath of fluid. 
Dehydration (which can happen before you 
ever feel thirsty) decreases cognitive function. 

(7) Talk about it. Out loud. 

Speaking activates a different part of 
the brain. If you’re trying to understand 
something, or increase your chance of 
remembering it later, say it out loud. Better 
still, try to explain it out loud to someone 
else. You’ll learn more quickly, and you might 
uncover ideas you hadn’t known were there 
when you were reading about it. 

( 8 ^ Listen to your brain. 

Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim 
the surface or forget what you just read, it’s 
time for a break. Once you go past a certain 
point, you won’t learn faster by trying to shove 
more in, and you might even hurt the process. 


(4) Don’t do all your reading in one place. 

Stand-up, stretch, move around, change 
chairs, change rooms. It’ll help your brain 
feel something, and keeps your learning from 
being too connected to a particular place. 

(5) Make this the last thing you read before 
bed. Or at least the last challenging thing. 

Part of the learning (especially the transfer 
to long-term memory) happens after you put 
the book down. Your brain needs time on 
its own, to do more processing. If you put in 
something new during that processing-time, 
some of what you just learned will be lost. 


(9) Feel something! 

Your brain needs to know that this matters. Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad 
joke is still better than feeling nothing at all. 

^ 6 ) Type and run the code. 

Type and run the code examples. Then you 
can experiment with changing and improving 
the code (or breaking it, which is sometimes 
the best way to figure out what’s really 
happening). For long examples or Ready-bake 
code, you can download the source files from 
headfirstjava.com 
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how to use this book 


What you need for this book: 


You do not need any other development tool, such as an Integrated 
Development Environment (IDE). We strongly recommend that you not 
use anything but a basic text editor until you complete this book (and 
especially not until after chapter 16). An IDE can protect you from some of 
the details that really matter, so you’re much better off learning from the 
command-line and then, once you really understand what’s happening, 
move to a tool that automates some of the process. 



—— SETTING UP JAVA - 

■ If you don’t already have a 1.5 or greater Java 2 Standard Edition SDK (Software 
Development Kit), you need it. If you’re on Linux, Windows, or Solaris, you can get it for free 
from java.sun.com (Sun’s website for Java developers). It usually takes no more than two clicks 
from the main page to get to the J2SE downloads page. Get the latest non-beta version posted. 
The SDK includes everything you need to compile and run Java. 

If you’re running Mac OS X 10.4, the Java SDK is already installed. It’s part of OS X, and you 
don’t have to do anything else. If you’re on an earlier version of OS X, you have an earlier 
version of Java that will work for 95% of the code in this book. 

Note: This book is based on Java 1.5, but for stunningly unclear marketing reasons, shortly 
before release, Sun renamed it Java 5, while still keeping “1.5” as the version number for the 
developer’s kit. So, if you see Java 1.5 or Java 5 or Java 5.0, or "Tiger" (version 5’s original 
code-name), they all mean the same thing. There was never a Java 3.0 or 4.0—it jumped from 
version 1.4 to 5.0, but you will still find places where it’s called 1.5 instead of 5. Don't ask. 

(Oh, and just to make it more entertaining, Java 5 and the Mac OS X 10.4 were both given the 
same code-name of “Tiger”, and since OS X 10.4 is the version of the Mac OS you need to run 
Java 5, you'll hear people talk about “Tiger on Tiger”. It just means Java 5 on OS X 10.4). 

■ The SDK does not include the API documentation, and you need that! Go back to java.sun. 
com and get the J2SE API documentation. You can also access the API docs online, without 
downloading them, but that’s a pain. Trust us, it’s worth the download. 

■ You need a text editor. Virtually any text editor will do (vi, emacs, pico), including the GUI ones 
that come with most operating systems. Notepad, Word pad, TextEdit, etc. all work, as long as 
you make sure they don’t append a “.txt” on to the end of your source code. 

■ Once you’ve downloaded and unpacked/zipped/whatever (depends on which version and for 
which OS), you need to add an entry to your PATH environment variable that points to the /bin 
directory inside the main Java directory. For example, if the J2SDK puts a directory on your 
drive called “j2sdk1.5.0", look inside that directory and you’ll find the “bin” directory where the 
Java binaries (the tools) live. Tha bin directory is the one you need a PATH to, so that when you 
type: 

% javac 

at the command-line, your terminal will know how to find the javac compiler. 

Note: if you have trouble with you installation, we recommend you go to javaranch.com, and join 
the Java-Beginning forum! Actually, you should do that whether you have trouble or not. 

Note: much of the code from this book is available at wickedlysmart.com 
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Last-mmutG things you weed to know: 

This is a learning experience, not a reference book. We deliberately 
stripped out everything that might get in the way of learning whatever it 
is we’re working on at that point in the book. And the first time through, 
you need to begin at the beginning, because the book makes assumptions 
about what you’ve already seen and learned. 

We use simple UML-like diagrams. 

If we’d used pure UML, you’d be seeing something that looks like Java, but 
with syntax that’s just plain wrong. So we use a simplified version of UML 
that doesn’t conflict with Java syntax. If you don’t already know UML, you 
won’t have to worry about learning Java and UML at the same time. 

We don’t worry about organizing and packaging your own 
code until the end of the book. 

In this book, you can get on with the business of learning Java, without 
stressing over some of the organizational or administrative details of 
developing Java programs. You will, in the real world, need to know — and 
use — these details, so we cover them in depth. But we save them for the end 
of the book (chapter 17). Relax while you ease into Java, gently. 

The end-of-chapter exercises are mandatory; puzzles are 
optional. Answers for both are at the end of each chapter. 

One thing you need to know about the puzzles — they’re puzzles. As in logic 
puzzles, brain teasers, crossword puzzles, etc. The exercises are here to help 
you practice what you’ve learned, and you should do them all. The puzzles 
are a different story, and some of them are quite challenging in a puzzle 
way. These puzzles are meant for puzzlers, and you probably already know if 
you are one. If you’re not sure, we suggest you give some of them a try, but 
whatever happens, don’t be discouraged if you can’t solve a puzzle or if you 
simply can’t be bothered to take the time to work them out. 

The ^Sharpen Your Pencil 9 exercises don’t have answers. 

Not printed in the book, anyway. For some of them, there is no right 
answer, and for the others, part of the learning experience for the Sharpen 
activities is for you to decide if and when your answers are right. (Some of 
our suggested answers are available on wickedlysmart.com) 

The code examples are as lean as possible 

It’s frustrating to wade through 200 lines of code looking for the two lines 
you need to understand. Most examples in this book are shown within the 
smallest possible context, so that the part you’re trying to learn is clear and 
simple. So don’t expect the code to be robust, or even complete. That’s 
your assignment for after you finish the book. The book examples are 
written specifically for learning, and aren’t always fully-functional. 
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tech editing: Jessica and Valentin 


Technical Editors 


“Credit goes to all, but mistakes are the sole reponsibility of the 
author".”. Does anyone really believe that? See the two people on 
this page? If you find technical problems, it’s probably their fault. : 


1/al ⑼知 C^ciia ； 
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Jess works at Hewlett-Packard on the Self- 
Healing Services Team. She has a Bachelor’s 
in Computer Engineering from Villanova 
University, has her SCPJ 1.4 and SCWCD 
certifications, and is literally months away 
from receiving her Masters in Software 
Engineering at Drexel University (whew!) 

When she’s not working, studying or 
motoring in her MINI Cooper S, Jess can 
be found fighting her cat for yarn as she 
completes her latest knitting or crochet 
project (anybody want a hat?) She is 
originally from Salt Lake City, Utah (no, 
she’s not Mormon... yes, you were too 
going to ask) and is currently living near 
Philadelphia with her husband, Mendra, and 
two cats: Chai and Sake. 

You can catch her moderating technical 
forums atjavaranch.com. 



Valentin Valentin Crettaz has a Masters degree 
in Information and Computer Science from 
the Swiss Federal Institute of Technology in 
Lausanne (EPFL). He has worked as a software 
engineer with SRI International (Menlo Park, 
CA) and as a principal engineer in the Software 
Engineering Laboratory of EPFL. 

Valentin is the co-founder and CTO of Condris 
Technologies, a company specializing in the 
development of software architecture solutions. 

His research and development interests 
include aspect-oriented technologies, design 
and architectural patterns, web services, and 
software architecture. Besides taking care of 
his wife, gardening, reading, and doing some 
sport, Valentin moderates the SCBCD and 
SCDJWS forums atjavaranch.com. He holds 
the SCJP, SCJD, SCBCD, SCWCD, and SCDJWS 
certifications. He has also had the opportunity 
to serve as a co-author for Whizlabs SCBCD 
Exam Simulator. 

(We’re still in shock from seeing him in a tie.) 
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Other people to bic：^: 

At O’Reilly: 

Our biggest thanks to Mike Loukides at O’Reilly，for taking a 
chance on this, and helping to shape the Head First concept into 
a book (and series). As this second edition goes to print there 
are now five Head First books, and he’s been with us all the way. 

To Tim O^Reilly, for his willingness to launch into something 
completely new and different. Thanks to the clever Kyle Hart for 
figuring out how Head First fits into the world, and for launching 
the series. Finally, to Edie Freedman for designing the Head First 
“emphasize the head’ cover. 

Our intrepid beta testers and reviewer team: 

Our top honors and thanks go to the director of ourjavaranch 
tech review team ， Johannes de Jong. This is your fifth time around 
with us on a Head First book, and we’re thrilled you’re still speaking 
to us. Jeff Cumps is on his third book with us now and relentless 
about finding areas where we needed to be more clear or correct. 

Corey McGlone, you rock. And we think you give the clearest 
explanations on javaranch. You’ll probably notice we stole one or 
two of them. Jason Menard saved our technical butts on more 
than a few details, and Thomas Paul, as always, gave us expert 
feedback and found the subtle Java issues the rest of us missed. 
Jane Griscti has her Java chops (and knows a thing or two about 
writing) and it was great to have her helping on the new edition 
along with long-time javarancher Barry Gaunt. 

Marilyn de Queiroz gave us excellent help on both editions of the 
book. Chris Jones，John Nyquist，James Cubeta，Terri Cubeta ， 
and Ira Becker gave us a ton of help on the first edition. 



Some o-f ou\r Java 

\TCV»C>/CV"S... 


Jc-f Cu» 


c 叫融 w 
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Special thanks to a few of the Head Firsters who’ve been helping 
us from the beginning: Angelo Celeste, Mikalai Zaikin ， and 
Thomas Duff (twduff.com). And thanks to our terrific agent, David 
Rogelberg of StudioB (but seriously, what about the movie rights?) 


Teiriri Cubc-fca 





Rodney J- 
Woodv-uW 


Chvis J< 
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still more acknowledgements 


Just whew you thought there wouldn't be awy 
more acknowledgements^. 


More Java technical experts who helped out on the first edition (in pseudo-random order): 

Emiko Hori, Michael Taupitz, Mike Gallihugh, Manish Hatwalne, James Chegwidden, 
Shweta Mathur, Mohamed Mazahim, John Paverd, Joseph Bih, Skulrat Patanavanich, 

Sunil Palicha, Suddhasatwa Ghosh, Ramki Srinivasan, Alfred Raouf, Angelo Celeste, 
Mikalai Zaikin, John Zoetebier, Jim Pleger, Barry Gaunt, and Mark Dielen. 

The first edition puzzle team: 

Dirk Schreckmann, Mary “JavaCross Champion” Leners, Rodney J. Woodruff, Gavin Bong, 
and Jason Menard. Javaranch is lucky to have you all helping out. 


Other co-conspirators to thank: 

Paul Wheaton, the javaranch Trail Boss for supporting thousands of Java learners. 

Solveig Haugland, mistress of J2EE and author of “Dating Design Patterns”. 

Authors Dori Smith and Tom Negrino (backupbrain.com) , for helping us navigate the 
tech book world. 

Our Head First partners in crime, Eric Freeman and Beth Freeman (authors of Head First 
Design Patterns), for giving us the Bawls™ to finish this on time. 

Sherry Dorris, for the things that really matter. 


Brave Early Adopters of the Head First series: 

Joe Litton, Ross P. Goldberg, Dominic Da Silva, honestpuck, Danny Bromberg, Stephen 
Lepp, Elton Hughes, Eric Christensen, Vulinh Nguyen, Mark Rau, Abdulhaf, Nathan 
Oliphant, Michael Bradly, Alex Darrow, Michael Fischer, Sarah Nottingham, Tim Allen, 
Bob Thomas, and Mike Bibby (the first). 


*The large number of acknowledgements is because we’re testing the theory that everyone mentioned in 
a book acknowledgement will buy at least one copy, probably more, what with relatives and everything. If 
you’d like to be in the acknowledgement of our next book, and you have a large family, write to us. 
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dive in A Quick Dip 


Breaking the Surface 



一 Come on, the waters 

great! Well dive right in and 
write some code, then compile and 
run it. Were talking syntax, looping 
and branching, and a look at what 
r makes Java so cool. Youll be 
k coding in no time. 


Java takes you to new places. From its humble release to the public as the 
(wimpy) version 1.02, Java seduced programmers with its friendly syntax, object-oriented features, 
memory management, and best of all —— the promise of portability.The lure of write-once/run- 
anywhere is just too strong. A devoted following exploded, as programmers fought against bugs, 
limitations, and, oh yeah, the fact that it was dog slow. But that was ages ago. If you're just starting in 
Java, you’re lucky. Some of us had to walk five miles in the snow, uphill both ways (barefoot), to 
get even the most trivial applet to work. But you, why,you get to ride the sleeker, faster, much 
more powerful Java of today. 



this is a new chapter 



the way Java works 


The Way Java Works 

The goal is to write one application (in this 
example，an interactive party invitation) and have 
it work on whatever device your friends have. 


source code for 
the interactive 
party invitation. 


Source 



O 

Create a source 
document. Use an 
established protocol 
(in this case, the Java 
language). 


Compiler 

❺ 

Run your document 
through a source code 
compiler.The compiler 
checks for errors and 
won’t let you compile 
until it’s satisfied that 
everything will run 
correctly. 



Method Party() 

0 aload_0 

1 invokespe- 
cial #1 < Method 
java.lang.Object()> 

4 return 


Output 

(code) 

❺ 




Virtual 

Machines 


The compiler creates a 
new document, coded 
into Java bytecode. 

Any device capable of 
running Java will be able 
to interpret/translate 
this file into something 
it can run.The compiled 
bytecode is platform- 
independent. 


o 

Your friends don’t have 
a physical Java Machine, 
but they all have a 
virtual Java machine 
(implemented in 
software) running inside 
their electronic gadgets. 
The virtual machine reads 
and runs the bytecode. 
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What you'll do m Java 

You’ll type a source code file, compile it using the 
javac compiler，then run the compiled bytecode 
on a Java virtual machine. 


import java.awt.*; 
import java.awt.event.*; 
class Party { 
public void buildlnvite() { 

Frame f = new Frame(); 

Label I = new Labelf Party at Tim’s”); 
Button b = new ButtonfYou bet ”)； 
Button c = new Buttonf Shoot me"); 
Panel p = new Panel(); 
p.add(l); 

} //morecode here... 


Source 

❶ 

Type your source code. 
Save as: Party.java 


File Edit Window Help Plead | 


javac Party.java 


Compiler 

❾ 

Compile the Party.java 
file by running j avac 
(the compiler application). 
If you don’t have errors, 
you’ll get a second docu¬ 
ment named Party.cl ass 

The compiler-generated 
Party.class file is made up 
of bytecodes. 


Method Partyf) 

0 aload_0 

1 invokespecial #1〈Method 
java.lang.Object()> 

4 return 

Method void buildlnvitef) 

0 new #2 <Class java.awt.Frame> 

3 dup 

4 invokespecial #3〈Method 
java.awt.Frame()> 


Output 

(code) 

❺ 

Compiled code: Party.class 


File Edit Window Help Swear | 


java Party 


©o o 

paityat 

f ¥du bfft 、 利 t M 1 # 


Virtual 

Machines 

O 

Run the program by 
starting the Java Virtual 
Machine (JVM) with the 
Party.class file.The JVM 
translates the bytecode 
into something the 
underlying platform 
understands, and runs 
your program. 


(hloic ： is hot mcaht io be a youll be 

wvitmg v-cal Code m 3 momerrt, but -fov y/c just 
wairt you -to y 七 a -feel -fov- how i 七 all *fi 七 s -togct^cv-.) 
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history of Java 


Classes in the Java standard library 


A verycrrief history of Java 


3500 


3000 


2500 


2000 


1500 


1000 


500 



Java 1.02 


NJLno classes 

slow. 

Cute name and logo. 
Fun to use. Lots of 
bugs.bpp/ets are 
the Big Thing. 


Java U 


Lnoo classes 

A //ff/e faster. 

M o rrD c QJ p cub lrD, 

Becoming very popu/ar 
Better GUI code. 


Java 2 

{versions 12'14J 

NJUJOO classes 

Much faster. 

Can (sometimes) run at 
native speeds. Serious, 
power?/. Comes in three 
flavors:Micro Edition (J2ME )， 
Standard mdition uNJcnm) and 
Enterprise Edition (J2EE). 
Becomes the /angc&ge of 
cho/ce for new enterprise 
(especially wecr-based) and 
moo-ile applications. 


Javas 

{versions L5 asdup} 

UJLnoo classes 

More power, easier^} 
develop with. 

Besides adding more than a 
thousand additional classes, 
Java 5.0 (known as "Tiger、、) 
added major changes to 
the language itself, making 
it easier (at least in theory) 
for programmers and giving 
it new features that were 
popular in other languages. 
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Look how easy it 
is to write Java. 


cf^irpen your pencil 


Try to guess what each line of code is doing... 
(answers are on the next page). 


int size = 27; 

String name = "Fido"; 

Dog myDog = new Dog(name, size); 
x = size - 5; 

if (x < 15) myDog.bark(8); 

while (x > 3) { 
myDog.play(); 

} 

int[] numList = {2,4,6,8}; 

System.out.print("Hello"); 

System.out.print( y/ Dog: " + name); 

String num = "8"; 

int z = 工 nteger.parselnt(num); 

try { 

readTheFile("myFile•txt"); 

} 

catch(FileNotFoundException ex) { 

System.out.print("File not found."); 

} 


dedlav-e an m-tcjcv variable hdmed 'si« , and jive i-t tKc value Zl 





I see Java 2 and Java 5.0, but was there a Java 3 
and 4? And why is it Java 5.0 but not Java 2.0? 

The joys of marketing... when the version of Java 
shifted from 1.1 to 1.2, the changes to Java were so 
dramatic that the marketers decided we needed a whole 
new "name’; so they started calling it Java 2, even though 
the actual version of Java was 1.2. But versions 1.3 and 1.4 
were still considered Java 2. There never was a Java 3 or 
4. Beginning with Java version 1.5, the marketers decided 


once again that the changes were so dramatic that a 
new name was needed (and most developers agreed), so 
they looked at the options.The next number in the name 
sequence would be "3’; but calling Java 1.5 Java 3 seemed 
more confusing, so they decided to name it Java 5.0 to 
match the "5 〃 in version "1.5’: 

So, the original Java was versions 1.02 (the first official 
release) through 1.1 were just "Java’: Versions 1.2,1.3, and 
1.4 were "Java 2’: And beginning with version 1.5, Java is 
called "Java 5.0': But you'll also see it called "Java 5〃（without 
the".0”）and "Tiger”（its original code-name). We have no 
idea what will happen with the next release... 
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why Java is cool 


cf^^rpen your pencil answers 


Look how easy it 
is to write Java. 


Don’t worry about whether you understand any of this yet! 

Everything here is explained in great detail in the book, most 
within the first 40 pages). If Java resembles a language you've 
used in the past, some of this will be simple. If not, don’t worry 
about it. We’ll get there... 


int size = 27; 

String name = "Fido 〃； 

Dog myDog = new Dog(name , size); 
x = size - 5; 

if (x < 15) myDog.bark(8); 


while (x > 3) { 
myDog.play(); 


int[] numList = {2,4,6,8}; 
System.out.print("Hello"); 

System.out.print(Dog : " + name); 

String num = "8"; 

int z = Integer.parselnt(num); 


try { 

readTheFile("myFile•txt"); 


catch(FileNotFoundException ex) { 

System, out. print ( yy File not found .”）； 


dedlav-e an 'mtcjcv variable named and jive \{ tKc value Z7 


dedlave a s-tvihg o-f dKaradtcrs variable earnedyve \{ tKc value w Fido w 


dedavc a hcv ； Doj variable ^yDoj and make tKc r\c\w Doj us'mj 


subtvadt ^ -fv-onn Z7 (value o-P 、 i«’）and assijh it to a variable earned 


% (vake ZZ) is less 七 I 弓 , tell tte d% to bavk 0 times 



keef I oof mg as long as x is gveatev- ttan 3". 


tell tKe do<^ to play (v/Katevev THAT meahs jo a doo| •> 


七 his looks like tKc Chd o-f tKc loop -- cvcirvtKmft m { } is dohe in the I o' 


ot 


dcdlavc a list oi m-tejevs variable VurmList, and pu-t 2 ■ ，午 A 必 ihto tKc list 


out w Hcllo w ... probably at tKc dormw^d-lme 


pv-mt out w Hcllo Fido w (the value Marine is w Fido w ) at tKc domw^d-ime 


dedlaire a dKaradtcv s-tvi^j variable and jive it tKc value oi W 0 W 


dohvcvt iKc stvihj o-f dKavadtcvs W 0 W mto ah adiual humevid value 0 



tv-y to do sonr»ctKmj...ififtaybc tKc tKmj v/cVc tiry'mj isn’t guav-a^-tccdi to v/ovk... 


read a text -file harmed w nr»yFilc t^t w (or at least TRY to read tKc -file-. ) 


must be tKc ciad oi tKc w tKihjs to tvy w , so | jucss you dould tv-y w»ahy 


七 his musi be y/Kcv-c you -f-mdi out i-f tKc iKmj you tvied did^t v/ovk... 
i-f tKc tKmj \wc tviedi -failed, W Filc hot *fouhd” out at tKc dornn^hd-lmc 


looks like cvcvytKmj m tKc {} is >/Ka*t to do i-f tKc 'tvy’ didn’t v/ovk... 
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Code structure iw Java 



What goes in a 

source file? 

A source code file (with the .java 
extension) holds one class defini¬ 
tion. The class represents a piece 
of your program, although a very 
tiny application might need just 
a single class. The class must go 
within a pair of curly braces. 


_ 

public class Dog { 


class 


Put a class in a source file. 
Put methods in a class. 

Put statements in a method. 


What goes in a 

class? 

A class has one or more methods. 
In the Dog class, the bark method 
will hold instructions for how the 
Dog should bark. Your methods 
must be declared inside a class 
(in other words, within the curly 
braces of the class). 


public class Dog { 

void bark() { 


method | 


What goes in a 

method? 

Within the curly braces of a 
method, write your instructions 
for how that method should be 
performed. Method code is basi¬ 
cally a set of statements, and for 
now you can think of a method 
kind of like a function or proce¬ 
dure. 


public class Dog { 
void bark() { 

statementl; 
statement2; 


statements 
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a Java class 


Anatomy of a class 

When the JVM starts running, it looks for the class you give it at the com¬ 
mand line. Then it starts looking for a specially-written method that looks 
exactly like: 

public static void main (String[] args) { 

// your code goes here 

} 

Next, the JVM runs everything between the curly braces { } of your main 
method. Every Java application has to have at least one class, and at least 
one main method (not one main per just one main per application). 



System.out.print (''I Rule!"); 


-this says *to sisJds^rd ou 七 fu 七 
(dc-faul*ts *to Imc) 


} \ dlos'm^ bvadc o-f method 


\ dlos'm^ Watt i\\t MyFi\rs*tApp 山 ss 


卜州 S 咖彳 

d rn a s〆— .. 




•the you 

七。七 


Do / 七 y/ov-vy abou 七 七 v\ovj - 

-this dhap*tc\r is jus 七七 。 yt you s*td\rtcd. 
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Writing a class with a main 

In Java, everything goes in a class. You’ll type your source code file (with a 
.java extension), then compile it into a new class file (with a . class extension). 
When you run your program, you’re really running a class. 

Running a program means telling the Java Virtual Machine (JVM) to “Load the 
Hello class, then start executing its main () method. Keep running ‘til all the 
code in main is finished.” 

In chapter 2, we go deeper into the whole class thing, but for now, all you need to 
think is, how do I write Java code so that it will run? And it all begins with main(). 

The main() method is where your program starts running. 

No matter how big your program is (in other words, no matter how many classes 
your program uses), there’s got to be a main() method to get the ball rolling. 


public class MyFirstApp { 

public static void main 
(String!) args){ 

System.out. printfl Rule!”); 

} 



MyFirstApp.java 



Method Party() 0 aload_0 1 I 
invokespecial #1〈Method 
java Jang.Object()> 

4 return 

Method void 
main(javaJang.StringQ) 

0getstatic#2<Field 

Myhiom |#|#bWIcISS 


public class JfyFirst^p { 

public static void main (String[] args) { 
Sys tern .out. pr in tin ('、I Rule!"); 

Sys tern .out. pr in tin ('' The World"); 


O Save 

MyFirstApp.java 

❺ Compile 

javac MyFirstApp.java 

❺ Run 

^N^^di^/Vindovi^eT^^crearT^^^^^ 


% java MyFirstApp 
I Rule! 

The World 
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statements, looping, branching 

What can you say m the main method? 

Once you’re inside main (or any method), the fun 
begins. You can say all the normal things that you say 
in most programming languages to make the computer 
do something. 

Your code can tell the JVM to: 


o do something 


Statements: declarations, assignments, 
method calls, etc. 

int x = 3; 

String name = 、 'Dirk 〃； 
x = x * 17; 

System. out .print (''x is ’’ + x); 
double d 二 Math.random(); 

// this is a comment 


❾ do something again and again 

Loops: for and while 

while (x > 12) { 


x 


x -1 



for (int x = 0; x < 10; x = x 
System. out. print (''x is now 


+ 1 ) { 
"+ x) 


玲 Each statement must end in a 
semicolon. 


x 


X 


冷 A single-line comment begins 
with two forward slashes. 


o do something under this condition 

Branching: if/else tests 

if (x == 10) { 

System. out .print (''x must be 10 ”）； 

} else { 

System. out .print (''x isn't 10 ”）； 

} 

if ( (x < 3) & (name • equals (''Dirk ”））） { 

System. out • print In (''Gently"); 

} 

System. out. print (''this line runs no matter what ’’）； 


x = 22; 

// this line disturbs me 

玲 Most white space doesn’t matter. 

x = 3 ; 


玲 Variables are declared with a 
name and a type (you’ll learn about 
all the Java types in chapter 3). 

int weight; 

// type : int, name : weight 

冷 Classes and methods must be 
defined within a pair of curly braces. 

public void go() { 

// amazing code here 
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while (moreBalls == true) { 



Looping and looping and... 

Java has three standard looping constructs: while, 
do-while, and for. You’ll get the full loop scoop later 
in the book, but not for awhile, so let’s do while for 
now. 

The syntax (not to mention logic) is so simple 
you’re probably asleep already. As long as some 
condition is true, you do everything inside the 
loop block. The loop block is bounded by a pair of 
curly braces, so whatever you want to repeat needs 
to be inside that block. 

The key to a loop is the conditional test. In Java, a 
conditional test is an expression that results in a 
boolean value — in other words, something that is 
either true or false. 

If you say something like, “While iceCreamlnTheTub 
is true, keep scooping”，you have a clear boolean 
test. There either is ice cream in the tub or there 
isn’t. But if you were to say, “While Bob keep 
scooping”，you don’t have a real test. To make 
that work, you’d have to change it to something 
like, “While Bob is snoring...” or “While Bob is not 
wearing plaid...” 


Simple boolean tests 

You can do a simple boolean test by checking 
the value of a variable, using a comparison operator 
including: 

< (less than) 

> (greater than) 

==(equality) (yes, that’s two equals signs) 

Notice the difference between the assignment 
operator (a single equals sign) and the equals 
operator {two equals signs). Lots of programmers 
accidentally type = when they want ==• (But not 
you.) 

int x = 4; // assign 4 to x 

while (x > 3) { 

// loop code will run because 

// x is greater than 3 

x = x - 1; //or we r d loop forever 

} 

int z = 27; // 
while (z == 17) { 

// loop code will not run because 
// z is not equal to 17 
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Java basics 


^tfcereiqrejiP 

Dumb Questions 

Why does everything have 
to be in a class? 

Java is an object-oriented 
(00) language. It's not like the 
old days when you had steam- 
driven compilers and wrote one 
monolithic source file with a pile 
of procedures. In chapter 2 you’ll 
learn that a class is a blueprint for 
an object, and that nearly every¬ 
thing in Java is an object. 

Do I have to put a main in 
every class I write? 

A. 

Jr \* Nope. A Java program 
might use dozens of classes (even 
hundreds), but you might only 
have one with a main method — 
the one that starts the program 
running. You might write test 
classes, though, that have main 
methods for testing your other 
classes. 

In my other language I can 
do a boolean test on an integer. 

In Java, can I say something like: 

int x = 1; 

while (x){ } 

A- 

Jr \ m No. A boolean and an 
integer are not compatible types in 
Java. Since the result of a condi¬ 
tional test must be a boolean, the 
only variable you can directly test 
(without using a comparison op¬ 
erator) is a boolean. For example, 
you can say: 

boolean isHot = true; 
while(isHot) { } 


Example of a while loop 

public class Loopy { 

public static void main (String[] args) { 


int x = 1; 


System. out. print In (''Before the Loop ’’）； 
while (x < 4) { 

System • out • println (''In the loop ’’）； 

System. out. print In (''Value of x is 〃 + x); 
x = x + 1 ; 

} 

System. out.println (''This is after the loop ”）； 


% java Loopy 
Before the Loop 
In the loop 
Value of x is 1 
In the loop 
Value of x is 2 



ihc ^ w 


In the loop 

Value of x is 3 

This is after the loop 


- BULLET POINTS - 

■ Statements end in a semicolon ; 

■ Code blocks are defined by a pair of curly braces {} 

■ Declare an int variable with a name and a type: int x; 

■ The assignment operator is one equals sign = 

■ The equals operator uses two equals signs == 

■ A while loop runs everything within its block (defined by curly 
braces) as long as the conditional test is true. 

■ If the conditional test is false, the while loop code block won’t 
run, and execution will move down to the code immediately 
after the loop block. 

■ Put a boolean test inside parentheses: 

while (x == 4) { } 
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Conditional branching 

In Java, an if test is basically the same as the boolean test in a 
while loop - except instead of saying, “while there’s still beer ".”， 
you’ll say, a if there's still beer".” 

class 工 fTest { 

public static void main (String[] args) { 

int x = 3; 
if (x == 3) { 

System. out. print In (''x must be 3 ”）； 

} 

System. out. print In (''This runs no matter what ’’）； 


% java IfTest 
x must be 3 
This runs no matter what 

The code above executes the line that prints “x must be 3” only 
if the condition (xis equal to 3) is true. Regardless of whether 
it’s true, though, the line that prints, “This runs no matter what” 
will run. So depending on the value of x, either one statement 
or two will print out. 

But we can add an else to the condition, so that we can 
say something like, “ 々 ^there’s still beer, keep coding, else 
(otherwise) get more beer, and then continue on...” 

class 工 fTest2 { 

public static void main (String[] args) { 

int x = 2; 
if (x == 3) { 

System. out. print In (''x must be 3 ”）； 

} else { 

System. out. print In (''x is NOT 3 ”）； 

} 

System. out. print In (''This runs no matter what"); 


% java IfTest2 
x is NOT 3 ^ 

This runs no matter what 


^ — C ° dt ou if>ui 


Systew.oot.priWt vs. 
Systew.out.prmtlll 

If you’ve been paying attention (of 
course you have) then you’ve noticed us 
switching between print and println. 

Did you spot the difference? 

System.out.pr/nf/n inserts a newline 
(think of print/n as printnei^line while 
System.out.pr/nf keeps printing to 
the same line. If you want each thing 
you print out to be on its own line, use 
println. If you want everything to stick 
together on one line, use print. 


-feiharpen your pencil 


Given the output: 

% java DooBee 
DooBeeDooBeeDo 


Fill in the missing code: 

public class DooBee { 
public static void main (String!] args) { 
int x = 1; 

while (x <_) { 

System.out._("Doo"); 

System.out._("Bee ”)； 

x = x + 1; 

} 

if (x ==_) { 

System.out.print("Do 〃)； 
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serious Java app 


Coding a Serious business 
Application 

Let’s put all your new Java skills to good use with 
something practical. We need a class with a main(), an int 
and a 汾 ring variable，a while loop, and an if test. A little 
more polish, and you’ll be building that business back¬ 
end in no time. But before you look at the code on this 
page, think for a moment about how you would code that 
classic children’s favorite, “99 bottles of beer.” 


public class BeerSong { 

public static void main (String[] args) 
int beerNum = 99; 



String word = ''bottles ”； 


while (beerNum > 0) { 

if (beerNum == 1) { 

word = ''bottle ”； // singular, as in ONE bottle. 

} 

System. out. print In (beerNum + '' 〃 + word + '' of beer on the wall ’’）； 
System. out. print In (beerNum + '' 〃 + word + '' of beer .’’）； 

System. out. print In (''Take one down .’’）； 

System. out. print In (''Pass it around .’’）； 
beerNum = beerNum - 1; 


if (beerNum > 0) { 

System. out. print In (beerNum + + word + '' of beer on the wall"); 

} else { 

System. out. print In (''No more bottles of beer on the wall ’’）； 

} // end else 
} // end while loop 
} // end main method 
} // end class 


There’s still one little flaw in our 
code. It compiles and runs, but the 
output isn’t 1 00% perfect. See if 
you can spot the flaw, and fix it. 
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Monday morning at Pob's 


dive In A Quick Dip 


Bob’s alarm clock rings at 8:30 Monday morning, just like every other weekday. 


But Bob had a wild weekend, and reaches for the SNOOZE button. 
And that’s when the action starts, and the Java-enabled appliances 
come to life. 



Java ihsicl^ 



First, the alarm clock sends a message to the coffee maker* “Hey, the geek’s 
sleeping in again, delay the coffee 12 minutes.” 





Finally, the alarm clock sends a message to 
Sam’s (Sam is the dog) wireless collar, with the too-familiar signal that 
means, “Get the paper, but don’t expect a walk.” 

A few minutes later, the alarm goes off again. And again Bob 
hits SNOOZE and the appliances start chattering. Finally, 
the alarm rings a third time. But just as Bob reaches for the 
snooze button, the clock sends the “jump and bark” signal to Sam’s 
collar. Shocked to full consciousness, Bob rises, grateful that his Java 
skills and a little trip to Radio Shack™ have enhanced the daily 




The coffee maker sends a message to the Motorola™ 
toaster, “Hold the toast, Bob’s snoozing.” 


Java here -too 


The alarm clock then sends a message to Bob’s 
Nokia Navigator™ cell phone, “Call Bob’s 9 
o’clock and tell him we’re running a little late.” 


routines of his life. 

His toast is toasted. 
His coffee steams. 
His paper awaits. 



bu*t*tcv heve 


Just another wonderful morning in The Java-Enabled House. 


You can have a Java-enabled home. Stick with a sensible solution using Java, 
Ethernet, andjini technology. Beware of imitations using other so-called “plug 
and play” (which actually means “plug and play with it for the next three days 
trying to get it to work”) or “portable” platforms. Bob’s sister Betty tried one of 
those others, and the results were, well, not very appealing, or safe. 

Bit of a shame about her dog, too... 


Could this story be true? Yes and no. While there are versions of Java running in de¬ 
vices including PDAs, cell phones [especially cell phones), pagers, rings, smart cards, 
and more -you might not find a Java toaster or dog collar. But even if you can’t 
find a Java-enabled version of your favorite gadget, you can still run it as if it were a 
Java device by controlling it through some other interface (say, your laptop) that is 
running Java.This is known as the Jini surrogate architecture.Yes you can have that 
geek dream home. 

*/P multicast if youYe gonna be all picky about protocol 

you are here ► 
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let’s write a program 



f Try my new 
^ phrase-o-matic and 
you’ll be a slick talker 
just like the boss or 
those guys in marketing. 


String[] wordListTwo = {''empowered", ''sticky", 
''value-added", 、 'oriented 〃， ''centric", ''distributed", 
''clustered", ''branded", 〃 outside-the-box〃，''positioned 
''networked", ''focused", ''leveraged", ''aligned", 
''targeted", ''shared", ''cooperative’’ ， ''accelerated"}; 


public class PhraseOMatic { 

public static void main (String[] args) { 


// make three sets of words to choose from. Add your own! 

String[] wordListOne = {''24/7", "multi- 
Tier" ,"30,000 foot", "B-to-B", "win-win", A, front- 
end", ''web-based","pervasive", ''smart", 
sigma", "critical-path", ''dynamic"}; 


six- 


f 


OK, so the beer song wasn’t really a serious 
business application. Still need something 
practical to show the boss? Check out the 
Phrase-O-Matic code. 


String[] wordListThree = {''process", ''tipping- 
point^ ,''solution", ''architecture", ''core competency", 
''strategy", ''mindshare", ''portal", ''space", ''vision", 
''paradigm", ''mission"}; 



thc ^d c do iis /r h，s ^ 

叫仏广 ^oird/li hc ^ 

9 ^iha ( a 1,. ^ ^ ^hch y< 

^1 you 

tu ^ do h ， “ 吐 C 伽 t 办 iy. 

〜〜 At : 卜 


❺ 


o 


// find out how many words are in each list 

int oneLength = wordListOne.length; 
int twoLength = wordListTwo.length; 
int threeLength = wordListThree.length; 

// generate three random numbers 

int randl = (int) (Math.random() * oneLength); 

int rand2 = (int) (Math.random() * twoLength); 

int rand3 = (int) (Math.random() * threeLength); 

// now build a phrase 

String phrase = wordListOne [ randl ] +'''' + 


wordListTwo [rand2 ] +'、'、+ wordListThree [rand3]; 



// print out the phrase 

System, out .pr in tin (''What we need is a 


+ phrase); 
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dive In A Quick Dip 


Phrase-O-Matic 

How it works. 

In a nutshell, the program makes three lists of words, then randomly picks one word 
from each of the three lists, and prints out the result. Don’t worry if you don’t under¬ 
stand exactly what ? s happening in each line. For gosh sakes, you’ve got the whole book 
ahead of you, so relax. This is just a quick look from a 30,000 foot outside-the-box 
targeted leveraged paradigm. 

The first step is to create three String arrays - the containers that will hold all the 
words. Declaring and creating an array is easy; here’s a small one: 

String[] pets = {''Fido", 、 'Zeus", ''Bin"}; 

Each word is in quotes (as all good Strings must be) and separated by commas. 


2^ For each of the three lists (arrays), the goal is to pick a random word, so we have 
to know how many words are in each list. If there are 14 words in a list, then we need 
a random number between 0 and 13 (Java arrays are zero-based, so the first word is at 
position 0, the second word position 1, and the last word is position 13 in a 14-element 
array). Quite handily, a Java array is more than happy to tell you its length. You just 
have to ask. In the pets array, we’d say: 

int x = pets.length; 

and x would now hold the value 3. 


what we need 
here is a... 


pervasive targeted 
process 


3* We need three random numbers. Java ships out-of-the-box, off-the-shelf, shrink- 
wrapped, and core competent with a set of math methods (for now, think of them as 
functions). The random () method returns a random number between 0 and not- 
quite-1, so we have to multiply it by the number of elements (the array length) in the 
list we’re using. We have to force the result to be an integer (no decimals allowed!) so 
we put in a cast (you’ll get the details in chapter 4). It’s the same as if we had any float¬ 
ing point number that we wanted to convert to an integer: 

int x = (int) 24.6; 

Now we get to build the phrase, by picking a word from each of the three lists, 
and smooshing them together (also inserting spaces between words). We use the “+” 
operator, which concatenates (we prefer the more technical 'smooshes) the String objects 
together. To get an element from an array, you give the array the index number (posi¬ 
tion) of the thing you want using: 

String s = pets [0] ; // s is now the String ''Fido" 
s = s + '' '' + ''is a dog"; // s is now ''Fido is a dog" 


dynamic outside- 
the-box tipping- 
point 


smart distributed 
core competency 


24/7 empowered 
mindshare 


30,000 foot win-win 
vision 


six-sigma net¬ 
worked portal 


3• Finally, we print the phrase to the command-line and... voila! Were in marketing. 
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the compiler and the JVM 


Fireside Chats 



Tonight’s Talk ： The compiler and 
the JVM battle over the question, 
“Who’s more important?” 


The Java Virtual Machine 

What, are you kidding? HELLO. I am Java. 
I’m the guy who actually makes a program 
run. The compiler just gives you 3. file. That’s 
it. Just a file. You can print it out and use it 
for wall paper, kindling, lining the bird cage 
what^^r, but the file doesn’t 办 anything un¬ 
less I’m there to run it. 

And that’s another thing, the compiler has 
no sense of humor. Then again, if you had to 
spend all day checking nit-picky little syntax 
violations... 


I’m not saying you’re ， like, completely useless. 
But really, what is it that you do? Seriously. I 
have no idea. A programmer could just write 
bytecode by hand, and I’d take it. You might 
be out of a job soon, buddy. 


The Compiler 


I don’t appreciate that tone. 


Excuse me, but without me, what exactly 
would you run? There’s a reason was 
designed to use a bytecode compiler, for your 
information. If Java were a purely interpreted 
language, where — at runtime — the virtual 
machine had to translate straight-from-a-text- 
editor source code, a Java program would 
run at a ludicrously glacial pace. Java’s had a 
challenging enough time convincing people 
that it’s finally fast and powerful enough for 
mostjobs. 


Excuse me, but that’s quite an ignorant (not 
to mention arrogant) perspective. While it 
is true that — theoretically — you can run any 
properly formatted bytecode even if it didn’t 
come out of a Java compiler, in practice that’s 
absurd. A programmer writing bytecode by 
hand is like doing your word processing by 
writing raw postscript. And I would appreciate 
it if you would not refer to me as “buddy.” 
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(I rest my case on the humor thing.) But you 
still didn’t answer my question, what do you 
actually do? 


dive In A Quick Dip 


The Java Virtual Machine 


But some still get through! I can throw Class- 
CastExceptions and sometimes I get people 
trying to put the wrong type of thing in an 
array that was declared to hold something 
else, and — 


OK. Sure. But what about security} Look at all 
the security stuff I do, and you’re like, what, 
checking for semicolons} Oooohhh big security 
risk! Thank goodness for you! 


Whatever. I have to do that same stuff too, 
though, just to make sure nobody snuck in 
after you and changed the bytecode before 
running it. 


Oh, you can count on it. Buddy. 


The Compiler 

Remember that Java is a strongly-typed lan¬ 
guage, and that means I can’t allow variables 
to hold data of the wrong type. This is a 
crucial safety feature, and I’m able to stop the 
vast majority of violations before they ever get 
to you. And I also — 


Excuse me, but I wasn’t done. And yes, there 
are some datatype exceptions that can emerge 
at runtime, but some of those have to be 
allowed to support one of Java’s other impor¬ 
tant features — dynamic binding. At runtime, 
a Java program can include new objects that 
weren’t even known to the original program¬ 
mer, so I have to allow a certain amount of 
flexibility. But my job is to stop anything that 
would never — could never — succeed at run¬ 
time. Usually I can tell when something won’t 
work, for example, if a programmer acciden¬ 
tally tried to use a Button object as a Socket 
connection, I would detect that and thus 
protect him from causing harm at runtime. 

Excuse me, but I am the first line of defense, 
as they say. The datatype violations I previous¬ 
ly described could wreak havoc in a program 
if they were allowed to manifest. I am also 
the one who prevents access violations, such 
as code trying to invoke a private method, or 
change a method that - for security reasons 
- must never be changed. I stop people from 
touching code they’re not meant to see, 
including code trying to access another class’ 
critical data. It would take hours, perhaps days 
even, to describe the significance of my work. 

Of course, but as I indicated previously, if I 
didn’t prevent what amounts to perhaps 99% 
of the potential problems, you would grind to 
a halt. And it looks like we’re out of time, so 
we’ll have to revisit this in a later chat. 
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exercise: Code Magnets 



ExeRciSd 



Code Magnets 

A working Java program is all scrambled up 
on the fridge. Can you rearrange the code 
snippets to make a working Java program 
that produces the output listed below? 
Some of the curly braces fell on the floor 
and they were too small to pick up, so feel 
free to add as many of those as you need! 



if (x 


2 ) 


System.out .print ( /y b c") 


class Shufflel { 

叶社虻 —^(String [j args) { | 



Output: 
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dive In A Quick Dip 



BE 如 compiler 



Each of {ke Java files on this pa^e 
represents a complete source file. 
Your job is to play compiler and 
determine whetiier each of tiiese 

files will compile. If they 
won’t compile, how 
would you fix {ken? 


public static void main(String [] args) { 
int x = 5; 
while ( x > 1 ) { 
x = x - 1; 
if ( x < 3) { 

System.out.println( iy small x〃）； 


A 

class Exerciselb { 

public static void main(String [] args) { 
int x = 1; 
while ( x < 10 ) { 
if ( x > 3) { 

System.out.println( w big x "); 


c 

class Exerciselb { 
int x = 5; 
while ( x > 1 ) { 
x = x - 1; 
if ( x < 3) { 

System.out.println("small x〃）； 
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puzzle: crossword 



Let’s give your right brain something to do. 

It’s your standard crossword, but almost all 
of the solution words are from chapter 1 Just 
to keep you awake, we also threw in a few 
(non-Java) words from the high-tech world. 


Across 

4. Command-line invoker 
6. Back again? 

8. Can’t go both ways 

9. Acronym for your laptop’s power 

12. number variable type 

13. Acronym for a chip 

14. Say something 

18. Quite a crew of characters 

19. Announce a new class or method 
21. What’s a prompt good for? 




1 


2 


3 

4 

5 






6 










7 









8 







9 

10 


11 






12 

















13 


14 


15 



16 






























17 


18 







19 





















20 
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Down 

1. Notan integer (or_your boat) 

2. Come back empty-handed 

3. Open house 

5. Things' holders 
7. Until attitudes improve 

10. Source code consumer 

11. Can’t pin it down 
13. Dept, of LAN jockeys 

15. Shocking modifier 

16. Just gotta have one 

17. How to get things done 

20. Bytecode consumer 
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dive In A Quick Dip 



Message 豸 


A short Java program is listed below. One block of the program 
is missing. Your challenge is to match the candidate block of 
code (on the left), with the output that you’d see if the block 
were inserted. Not all the lines of output will be used, and some 
of the lines of output might be used more than once. Draw lines 
connecting the candidate blocks of code with their matching 
command-line output. (The answers are at the end of the chapter). 


class Test { 

public static void main(String 
int x = ◦; 
int y = 0; 
while ( x < 5 ) { 


[]args) 


System.out.print(x 


\\ \\ 


y 




? ossA >\ C 。咖 A 


X = 

} 

} 

= X 

Candidates: 

y = x - 

- y; 


y = y H 

卜 X; 


3°cs ^ 


y 

— 

y + 

2 ； 

ij 

=( 

y > 

4 ) { 


y 

= y 

-1; 

} 





Possible output: 


22 46 


11 34 59 


02 14 26 38 


02 14 36 48 


X = X H 

卜 1; 

y = y H 

卜 X; 


if ( y < 5 ) 

{ 

x = x + 1; 


if ( y < 3 

){ 

x = x -] 

L ； 

} 


} 


y = y + 2 ； 



00 11 21 32 42 


11 21 32 42 53 


00 11 23 36 410 


02 14 25 36 47 


^odc 
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puzzle: Pool Puzzle 



P 祕 1 puzz]c 



Your job is to take code snippets from the 
pool and place them into the blank 
lines in the code. You may not use the 
same snippet more than once, and 
you won’t need to use all the snip¬ 
pets.Your goa/ is to make a class that 
will compile and run and produce the 
output listed. Don’t be fooled — this one’s 


harder than it looks. 


class PoolPuzzleOne { 

public static void main(String [] args) { 
int x = 0; 

while ( _ ) { 


if ( x < 1 ) { 


if ( 


Output 

^N^^di^/Vindovi^ei^^heat 


% java PoolPuzzleOne 
a noise 
annoys 
an oyster 


if ( x == 1 ) { 


if ( 


System.out.printIn(""); 
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Exercise Solutions 


Code Magnets ： 

class Shufflel { 

public static void main(String [] args) { 

int x = 3; 
while (x > 0) { 


class Exerciselb { 

public static void main(String [] args) { 
int x = 1; 
while ( x < 10 ) { 

X = X + 1; 
if ( x > 3) { 

System.out.println("big x 〃）； 

} 

} 

} This will compile and run (no output), but 
} without a line added to the program, it 

would run forever in an infinite while' loop! 


if (x > 2) { 

System.out.print("a ”）； 

} 

x = x - 1; 

System, out. print ( 

if (x == 2) { 

System.out .print ( JJ b c ’’）； 

} 

if (x == 1) { 

System.out.print("d 〃）； 
x = x - 1; 



class Foo { 

public static void main(String [] args) { 
int x = 5; 
while ( x > 1 ) { 
x = x - 1; 

B if ( x < 3) { 

System.out.println("small x 〃）； 

} 

} This file wont compile without a 
} class declaration, and don't forget 
} the matching curly brace! 


class Exerciselb { 

public static void main(String [] args) { 

int x = 5; 
while ( x > 1 ) { 
x = x - 1; 

C if ( X < 3) { 

System.out.println("small x 〃）； 

} 

^ The while 1 loop code must be in- 
^ side a method. It cant just be 
^ hanging out inside the class. 
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puzzle answers 



class PoolPuzzleOne { 

public static void main(String [] args) { 
int x = 0; 

while ( X < 4 ) { 

System, out • print(V’)； 

if ( x < 1 ) { 

System.out.printC %% )/ 

} 

System, out • printCn"); 

if ( X > 1 ) { 

System.out.printC % oyster*); 
x = x + 2; 

} 

if ( x == 1 ) { 

System, out • printC'noys #, ); 

} 

if ( X < 1 ) { 

System, out • printC'oise #, ); 

} 

System.out.println(; 

X = X + 1; 


annoys 
an oyster 


J 


B 


A 


R 


R 


A 


y 


14 


S 


A 


A 


C 


y 


18 


S 


15 


S 


T 


A 


C 


W 


]2 l 


R 


I 


N 


0 


A 


0 


£ 

I 


D 


16 . 


A 


I 


N 


0 


G 


19 


D 


0 


M 


I 


R 


21 


C 


0 


R 


C 


20 


J 


M 




A 


R 


I 


A 


B 


1 


JJ 

B 


L 


I 


C 


A 


R 


M 


A 


17 


工 

H 


0 


D 


class Test { 

public static void main(String [] args) 
int x = 0; 
int y = 0; 
while ( x < 5 ) { 


System.out.print(x + 
x = x + 1 ; 


y 


)； 


Candidates: 


Possible output: 


y = 

= X - 

- y; 


y = 

=y H 

h X; 



y = 

y + 

2 ； 

| File Edit Window Help Cheat 

if( 

y > 

4 ) { 

% java PoolPuzzleOne 

y 

= y 

- 1; 

a noise 

> 




X = 

=X H 

卜 i; 

y = 

=y H 

h X; 


if ( y 

<5 

) 

{ 

X = X + ] 

L; 


if ( 

y < 

3 

){ 

x = 

X - 

- ] 

L; 

> 




> 




y = y + 

2 ； 





22 46 


11 34 59 


02 14 26 38 


02 14 36 48 


00 11 21 32 42 


11 21 32 42 53 


00 11 23 36 410 


02 14 25 36 47 
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2 classes and objects 


A Trip to Objectville 



I was told there would be objects. In chapter 1, we put all of our code in the 
main() method. That's not exactly object-oriented. In fact, that's not object-oriented at all. Well, 
we did use a few objects, like the String arrays for the Phrase-O-Matic, but we didn’t actually 
develop any of our own object types. So now we’ve got to leave that procedural world behind, 
get the heck out of main。, and start making some objects of our own. Well look at what makes 
object-oriented (00) development in Java so much fun. We’ll look at the difference between 
a class and an object. We’ll look at how objects can give you a better life (at least the program¬ 
ming part of your life. Not much we can do about your fashion sense). Warning: once you get 
to Objectville,you might never go back. Send us a postcard. 
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once upon a time in Objectville 



Chair Wars 

(or How Objects Can Change Your Life) 

nee upon a time in a software shop, two 
programmers were given the same spec and told to 
“build it”. The Really Annoying Project Manager 
forced the two coders to compete, 
by promising that whoever delivers 
first gets one of those cool Aeron™ 
chairs all the Silicon Valley guys have. 

Larry, the procedural programmer, and 
Brad, the OO guy, both knew this would 
be a piece of cake. 

Larry, sitting in his cube, thought to 
himself, “What are the things this program 
has to do} What procedures do we need?”. 

And he answered himself, “rotate and 
playSound.” So off he went to build the 
procedures. After all, what is a program if not 
a pile of procedures? 

Brad, meanwhile, kicked back at the cafe 
and thought to himself, “What are the things 
in this program... who are the key players?’ He 
first thought of The Shapes. Of course, there 
were other objects he thought of like the User, the Sound, 
and the Clicking event. But he already had a library of code 
for those pieces, so he focused on building Shapes. Read 
on to see how Brad and Larry built their programs, and 
for the answer to your burning question, “So, who got the 
Aeron?^ 


the spec 



伽一^:工 a 

cloche 匕肌 

:: 工—一一 r 

slaape- 




Iw Larry's cube 

As he had done a gazillion times before, Larry 
set about writing his Important Procedures. 
He wrote rotate and playSound in no time. 

rotate (shapeNum) { 

// make the shape rotate 360 0 

} 

playSound(shapeNum) { 

// use shapeNum to lookup which 
// AIF sound to play, and play it 


At Prad's laptop at the cafe 

Brad wrote a class for each of the three shapes 


Square 


rotate^ { 

II code to rotate a s 
} 


Circle L 

rotate。{ 

Triangle 

playSound() { 

II code to play the 户 
II for a square 

II code to rotate a ( 
} 

playSound() { 

II code to play the; 

rotate() { 

II code to rotate a triangle 
} 


II for a circle 
} 

playSound() { 

II code to play the AIF file 




// for a triangle 

} 
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classes and objects 


Larry thought he'd nailed it. He could almost feel the rolled 
steel of the Aerow beneath his... 


Put wait! There's been a spec change. 

“OK, technically you were first, Larry,” said the Manager, “but we have to add just one 
tiny thing to the program. It’ll be no problem for crack programmers like you two.” 


“If I had a dime for every time I’m heard that one”, thought Larry, knowing that spec- 
change-no-problem was a fantasy. “Andyet Brad looks strangely serene. What’s up with 
thatV’ Still, Larry held tight to his core belief that the OO way, while cute, was just 
slow. And that if you wanted to change his mind, you’d have to pry it from his cold, 


dead, carpal-tunnelled hands. 


an amo eloa 綱 6 


_ o^ers. 

辦 route 

: :0_多 


what got added to the spec 


Pack in Larry's cube 


At Prad's laptop at the beach 


The rotate procedure would still work; the code used 
a lookup table to match a shapeNum to an actual 
shape graphic. But playSound would have to change. 
And what the heck is a .hif file? 

playSound(shapeNum) { 

// if the shape is not an amoeba , 

II use shapeNum to lookup which 
// AIF sound to play, and play it 
// else 

// play amoeba .hif sound 

} 

It turned out not to be such a big deal, but it still 
made him queasy to touch previously-tested code. Of 
all people, he should know that no matter what the 
project manager says, the spec always changes. 


Brad smiled, sipped his margarita, and wrote one 
new class. Sometimes the thing he loved most 
about OO was that he didn’t have to touch code 


he’d already tested and delivered. “Flexibility, 
extensibility，".” he mused, reflecting on the 


benefits of OO. 


Amoeba 

rotate() { 

II code to rotate an amoeba 

} 

playSound() { 

II code to play the new 
II .hif file for an amoeba 


you are here ► 29 





once upon a time in Objectville 


Larry snuck in just moments ahead of Prad. 

(Hah! So much for that foofy OO nonsense). But the smirk on Larry’s face melted when the 
Really Annoying Project Manager said (with that tone of disappointment), “Oh, no, that’s not 
how the amoeba is supposed to rotate...” 

Turns out, both programmers had written their rotate code like this: 

1) determine the rectangle that surrounds the shape 

2) calculate the center of that rectangle, and rotate the shape around that point. 

But the amoeba shape was supposed to rotate around a point on one end, like a clock hand. 

“I’m toast.” thought Larry, visualizing charred Wonderbread™. u Although, hmmmm. I could 
just add another if/else to the rotate procedure, and then just hard-code the rotation point 
code for the amoeba. That probably won’t break anything.” But the little voice at the back of 
his head said, “BigMistake. Do you honestly think the spec won’t change again?” 




Pack in Larry's cube 

He figured he better add rotation point arguments 
to the rotate procedure. A lot of code was affected. 
Testing, recompiling, the whole nine yards all over 
again. Things that used to work, didn’t. 

rotate(shapeNum, xPt, yPt) { 

// if the shape is not an amoeba , 

II calculate the center point 
// based on a rectangle, 

// then rotate 
// else 

// use the xPt and yPt as 
// the rotation point offset 
// and then rotate 



What the spec cowvewiehtly 
forgot to mehtioh 


At Prad's laptop on his lawn 
chair at the Telluride 由 uegrass Festival 


Amoeba 


Without missing a beat, Brad modified the rotate 
method, but only in the Amoeba class. He never 
touched the tested ， working ， 
compiled code for the othe 
parts of the program. To 
give the Amoeba a rota¬ 
tion point, he added an 
attribute that all Amoebas 
would have. He modi¬ 
fied, tested, and delivered 
(wirelessly) the revised 
program during a single 
Bela Fleck set. 




int xPoint 
int yPoint 

rotate() { 

II code to rotate an amoeba 
II using amoeba’s x and y 

} 

playSound() { 

II code to play the new 
II .hif file for an amoeba 
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classes and objects 


So, Prad the 00 guy got the chair ： right? 

Not so fast. Larry found a flaw in Brad’s approach. And, 
since he was sure that if he got the chair he’d also get Lucy 
in accounting, he had to turn this thing around. 

LARRY: You’ve got duplicated code! The rotate 
procedure is in all four Shape things. 

BRAD: It’s a method, not a procedure. And they’re classes, 
not things. 

LARRY: Whatever. It’s a stupid design. You have to 
maintain four different rotate “methods”. How can that 
ever be good? 

BRAD: Oh, I guess you didn’t see the final design. Let me 
show you how OO inheritance works, Larry. 



What Larry wanted 
(figured the chair would impress her) 


Square 


Circle 


Triangle 


Amoeba 

rotate() 

playSoundQ 

rotate() 

playSoundQ 


rotate() 

playSoundQ 


rotate () 
playSoundQ 


o 

I looked at what all four 
classes have m common. 

4 ^ 



They're Shapes, ami they all rotate awd 
playSouhd. Sol abstracted out the 
commow features ahd put them mtoa 
new class called Shape. ^ 


Shape 


rotate() 

playSoundQ 


superclass 


Shape 


rotate () 
playSoundQ 


❺ 

Thcwl lihked the other 
four shape classes to 
the wew Shape class, 
ma relationship called 


You can read this as, “Square inherits from Shape ”， 
“Circle inherits from Shape ”， and so on. I removed 
rotate() and playSound() from the other shapes, so now 
there’s only one copy to maintain. 

The Shape class is called the superclass of the other four 
classes. The other four are the subclasses of Shape. The 
subclasses inherit the methods of the superclass. In other 
words, if the Shape class has the functionality, then the 
subclasses automatically get that same functionality. 



Square 


Circle 


Triangle 


Amoeba 
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once upon a time in Objectville 


What about the Amoeba rotate!)? 

LARRY: Wasn’t that the whole problem here — that the amoeba shape 
had a completely different rotate and playSound procedure? 

BRAD: Method. 

LARRY: Whatever. How can amoeba do something different if 
it “inherits” its functionality from the Shape class? 

BRAD: That’s the last step. The Amoeba class overrides the 
methods of the Shape class. Then at runtime, the JVM knows exactly 
which rotate () method to run when someone tells the Amoeba to rotate. 




o 

I made the Amoeba class override 
the rotated awd playSouhdO 
methods of the superclass Shape. 


Overriding just means that a 
subclass redefmes owe of its 
mherited methods whew it needs 
to change or extend the behavior 
of that method. 


4 ^ 


Overriding methods 


LARRY: How do you “tell” an Amoeba to 
do something? Don’t you have to call the 
procedure, sorry — method, and then tell it 
which thing to rotate? 

BRAD: That’s the really cool thing about OO. 
When it’s time for, say, the triangle to rotate, 
the program code invokes (calls) the rotate () 
method on the triangle object. The rest of the 
program really doesn’t know or care how the 
triangle does it. And when you need to add 
something new to the program, you just write 
a new class for the new object type, so the new 
objects will have their own behavior. 




I know how a Shape is 
supposed to behave. Your 
job is to tell me what to 
do, and my job is to make it happen. 
Don't you worry your little program¬ 
mer head about how I do it. 


I can take 
care of myself. 

I know how an Amoeba 
is supposed to rotate 
and play a sound. 
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classes and objects 


The suspense is killing me. 

Who got the chair? 

ny from the second floor. 

mbeknownst to all, the Project 
anager had given the spec to 
ree programmers.) 


What do you like about 00? 

''It helps me design in a more natural way. Things 
have a way of evolving.” 

-Joy, 27, software architect 

''Not messing around with code Ive already 
tested, just to add a new feature/ 1 

-Brad, 32, programmer 

、、I like that the data and the methods that oper¬ 
ate on that data are together in one class/ 1 

-Josh, 22, beer drinker 

''Reusing code in other applications. When I write 
a new class, I can make it flexible enough to be 
used in something new, later/ 1 

-Chris, 39, project manager 

、、I can’t believe Chris just said that. He hasn't 
written a line of code in 5 years." 

-Daryl, 44, works for Chris 

''Besides the chair?” 

-Amy, 34, programmer 



Time to pump some neurons. 

You just read a story bout a procedural 
programmer going head-to-head with an 00 
programmer. You got a quick overview of some 
key 00 concepts including classes, methods, and 
attributes. We’ll spend the rest of the chapter 
looking at classes and objects (we’ll return to 
inheritance and overriding in later chapters). 

Based on what you’ve seen so far (and what you 
may know from a previous 00 language you’ve 
worked with), take a moment to think about 
these questions: 

What are the fundamental things you need to 
think about when you design a Java class? What 
are the questions you need to ask yourself? 

If you could design a checklist to use when 
you’re designing a class, what would be on the 
checklist? 



tif 


If you’re stuck on an exercise, try talking about 
it out loud. Speaking (and hearing) activates 
a different part of your brain. Although it 
works best if you have another person to 
discuss it with, pets work too. That’s how 
our dog learned polymorphism. 
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thinking about objects 


Whew you design a class, think about the objects that 
will be created from that class type, think about: 

■ things the object knows 

■ things the object does 


ShoppingCart 


Button 


Alarm 

cartContents 

knows 

label 

color 

knows 

alarmTime 

alarmMode 

addToCart() 

removeFromCart() 

checkOut() 

does 

setColor() 

setLabel() 

dePress() 

unDepress() 

does 

setAlarmTime() 

getAlarmTimeO 

isAlarmSet() 

snooze() 


knows 

does 


Things an object knows about itself are called 

■ instance variables 

Things an object can do are called 

■ methods 


instance 

variables 

(state) 

methods 

(behavior) 


Song 


title 

artist 


setTitle() 

setArtist() 

play() 


knows 

does 


Things an object knows about itself are called instance 
variables. They represent an object’s state (the data), and 
can have unique values for each object of that type. 

Think of instance as another way of saying object. 

Things an object can do are called methods. When you 
design a class, you think about the data an object will need 
to know about itself, and you also design the methods 
that operate on that data. It’s common for an object to 
have methods that read or write the values of the instance 
variables. For example, Alarm objects have an instance 
variable to hold the alarmTime, and two methods for 
getting and setting the alarmTime. 

So objects have instance variables and methods, but those 
instance variables and methods are designed as part of the 
class. 



Fill in what a television object 
might need to know and do. 




instance 

variables 


methods 


34 


































classes and objects 


What’s the difference between 
a class and an object? 


DOG 

size 

breed 


one class 




many objects 


name 


bark() 


A class is notan object. 

(but ifs used to construct them) 


A class is a blueprint for an object. It tells the 
virtual machine how to make an object of that 
particular type. Each object made from that 
class can have its own values for the 
instance variables of that class. For 
example, you might use the Button 
class to make dozens of different 
buttons, and each button might have 
its own color, size, shape, label, and so on. 



摘 


dlass 


Lool atitAis waV... 


An object is like one entry in your address book. 


__ /Q -S 

Nw—^ N - P V 
P Nnpie / L - M 
e n u —一 PoLLi 


e 


Name Poll H Morfism. 

Phone 555 - 03 > 今 3 > _ 

e M a “ 


One analogy for objects is a packet of unused Rolodex™ cards. 

Each card has the same blank fields (the instance variables). When 
you fill out a card you are creating an instance (object), and the 
entries you make on that card represent its state. 

The methods of the class are the things you do to a particular card; 
getName(), changeName(), setName() could all be methods for 
class Rolodex. 

So, each card can do the same things (getName(), changeName(), 
etc.), but each card knows things unique to that particular card. 
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making objects 


Makmg your first object 


So what does it take to create and use an object? You need two classes. One 
class for the type of object you want to use (Dog, AlarmClock, Television, 
etc.) and another class to test your new class. The tester class is where you put 
the main method, and in that main() method you create and access objects 
of your new class type. The tester class has only one job: to try out the meth¬ 
ods and variables of your new object class type. 

From this point forward in the book, you’ll see two classes in many of 
our examples. One will be the real class - the class whose objects we 
really want to use, and the other class will be the tester class, which we 
call < whateverYourClassNamels > TestDrive. For example, if we make a 
Bungee class, we’ll need a BungeeTestDrive class as well. Only the 
<someClassName>T&stDri'v& class will have a main() method, and its sole 
purpose is to create objects of your new type (the not-the-tester class), and 
then use the dot operator (.) to access the methods and variables of the new 
objects. This will all be made stunningly clear by the following examples. 


❹ Write your class 


class Dog { 


size 


int 

String breed; 
String name; 




啊 城 s 


a ^c*thod 


void bark() { 

System. out. println (''Ruff! Ruff ! ,r ) 

} 



❺ 


The Dot Operator (.) 

The dot operator (•) gives 
you access to an object’s 
state and behavior (instance 
variables and methods). 


// make a new object 

Dog d = new Dog(); 


// tell it to bark by using the 
// dot operator on the 
// variable d to call bark() 

d.bark(); 

// set its size using the 
// dot operator 

d.size = 40; 


Write a tester (TestDrive) class 


class DogTestDrive 




㈣ 


^ public static void main (String[] args) { 

3 \ ^ l // Dog test code goes here 


dot 

o ^ ； 


❺ 


In your tester, moke an object and access 
the objects variables and methods 


class DogTestDrive { 

public static void main (String[] args) { 
Dog d = new Dog() 
d.size = 40; 

.bark() 


“ 叫 ， £ 

the do*t opc\ra*tov- O 


II i WkO ^ od 


If you already have some 00 savvy, 
you'll know were not using encapsulation. 
We'll get there in chapter 4. 
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classes and objects 


Making and testing Movie objects 



class Movie { 

String title; 

String genre; 
int rating; 

void playlt() { 

System, out .println (''Playing the movie 〃）； 


public class MovieTestDrive { 

public static void main(String[] args) { 

Movie one = new Movie(); 

one. title = ''Gone with the Stock 〃； 

one. genre = ''Tragic"; 

one.rating = -2; 

Movie two = new Movie(); 

two. title = ''Lost in Cubicle Space^; 

two. genre = ''Comedy"; 

two.rating = 5; 

two.playlt(); 

Movie three = new Movie(); 
three. title = ''Byte Club 〃 ； 

three.genre = ''Tragic but ultimately uplifting"; 
three.rating = 127; 


MOVIE 

title 

genre 

rating 

playlt() 



object 1 g enre 
, rating 

C title 


The MovieTestDrive class creates objects (instances) of 
the Movie class and uses the dot operator (.) to set the 
instance variables to a specific value.The MovieTestDrive 
class also invokes (calls) a method on one of the objects. 
Fill in the chart to the right with the values the three 
objects have at the end of main(). 


object 2 


genre 

rating 


object 3 


title 


genre 

rating 


A 

y 

J 

a 

J 
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get the heck out of main 

Quick! fret out of mam! 

As long as you’re in main(), you’re not really in Objectville. It’s fine for a test 
program to run within the main method, but in a true OO application, you 
need objects talking to other objects, as opposed to a static main() method 
creating and testing objects. 

The two uses of main: 

■ to test your real class 

■ to launch/start your Java application 

A real Java application is nothing but objects talking to other objects. In this 
case, talking means objects calling methods on one another. On the previous 
page, and in chapter 4 , we look at using a main() method from a separate 
TestDrive class to create and test the methods and variables of another class. In 
chapter 6 we look at using a class with a main() method to start the ball rolling 
on a 籠 /Java application (by making objects and then turning those objects 
loose to interact with other objects, etc.) 

As a ‘sneak preview’ ， though, of how a real Java application might behave, 
here’s a little example. Because we’re still at the earliest stages of learning Java, 
we’re working with a small toolkit, so you’ll find this program a little clunky 
and inefficient. You might want to think about what you could do to improve 
it, and in later chapters that’s exactly what we’ll do. Don’t worry if some of the 
code is confusing; the key point of this example is that objects talk to objects. 

The Guessing &ame 

Summary: 

The guessing game involves a 'game' object and three 'player’ objects.The game gen¬ 
erates a random number between 0 and 9, and the three player objects try to guess 
it. (We didn't say it was a really exciting game.) 

Classes: 

GuessGame.class Player.class GameLauncher.class 

The Logic: 

1) The GameLauncher class is where the application starts; it has the main () method. 

2) In the main () method, a GuessGame object is created, and its startGameO method 
is called. 

3) The GuessGame object’s startGameO method is where the entire game plays out. 

It creates three players, then "thinks” of a random number (the target for the players 
to guess). It then asks each player to guess, checks the result, and either prints out 
information about the winning player(s) or asks them to guess again. 



6 

m 

a 

G 

s 

s 

6 

Gu 


内 P2 P3 
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classes and objects 


public class GuessGame 
Player pi; 

Player p2; 

Player p3; 


: 從 “ e C s fe 


public void startGame() 
pi = new Player(); 
p2 = new Player (); 
p3 = new Player(); 



⑽ Wc variables 7 


int guesspl 
int guessp2 
int guessp3 


S ： ^ ^ ，敬 iabl« to hold the 

0 ； ▽ thircc guesses -the Play cv . s ^ 


boolean plisRight 
boolean p2isRight 
boolean p3isRight 


false; <^ ^ variables to hold a OV- 

false; 七 alse bdsed Oh "tKc player’s dhsy /饮 


int targetNumber = (int) (Math.random() * 10); 

System•out.println('V m thinking of a number between 0 and 9... 




while (true) { 

System, out. println (''Number to guess is '' + targetNumber); 


a that the 

playc\rs have -to guess 


p2* guess (); ^ ^ ^ 11 ^ 9^ss0 method 

p3.guess (); 


guesspl = pi.number; 

System, out .println (''Player one guessed '' 
guessp2 = p2.number; 

System, out .println (''Player two guessed '' 
guessp3 = p3.number; 

System, out .println (''Player three guessed 


guesspl); 


guessp2); 


guessp3); 


^ P, la y^s guess (the result ol 
9 ucss( ^ method iruhhihg) by a^ess'ma £he 
hur^bev- variable o-r player 


if (guesspl == targetNumber) { 
plisRight = true; 

} 

if (guessp2 == targetNumber) { 
p2isRight = true; 

} 

if (guessp3 == targetNumber) { 
p3isRight = true; 


cath playev s guess to see i-f it niches 
J hc tayt hurhbc\r. \\ a flayev- is v-iaht, 
peh set that playev-s vav-iablc io be 
C\rCrhCrhbc\r, y/C 兄七 _ 七 -false by default) 


if (plisRight || p2isRight || p3isRight) { 


2 t ? ：：： u R ^ 0R ^ w is ^ 


System, out .println (''We have a winner !”）； 

System. out.println (''Player one got it right? '' + plisRight); 
System. out.println (''Player two got it right? '' + p2isRight); 
System. out.println (''Player three got it right? '' + p3isRight); 
System, out .println (''Game is over . r, ); 
break; // game over, so break out of the loop 


} else { 

// we must keep going because nobody got it right! 

System. out. println (''Players will have to try again .”）； 

} // end if/else 
} // end loop 
} // end method 
} // end class 


3sk ihe 
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Guessing Game 


Runnmg the &uessmg &ame 

public class Player { 

int number =0; // where the guess goes 


public void guess () { 

number = (int) (Math.random() * 10); 
System• out • println (''I' m guessing、' 

+ number); 


public class GameLauncher { 

public static void main (String[] args) 
GuessGame game = new GuessGame(); 
game.startGame(); 


Java takes out the 
Garbage 

Each time an object is created 
in Java, it goes into an area of 
memory known as The Heap. 

All objects — no matter when, where, 
or how they’re created - live on the 
heap. But it’s not just any old memory 
heap; the Java heap is actually called the 
Garbage-Collectible Heap. When you 
create an object, Java allocates memory 
space on the heap according to how 
much that particular object needs. An 
object with, say, 15 instance variables, 
will probably need more space than an 
object with only two instance variables. 
But what happens when you need to 
reclaim that space? How do you get an 
object out of the heap when you’re done 
with it? Java manages that memory 
for you! When the JVM can "see" that an 
object can never be used again, that 
object becomes eligible for garbage 
collection. And if you’re running low on 
memory, the Garbage Collector will run, 
throw out the unreachable objects, and 
free up the space, so that the space can 
be reused. In later chapters you’ll learn 
more about how this works. 


Output (it will be different each time you run it) 


% java GameLauncher 

I'm thinking of a number between 0 and 9 

Number to guess is 7 

I'm guessing 1 

I'm guessing 9 

I'm guessing 9 

Player one guessed 1 

Player two guessed 9 

Player three guessed 9 

Players will have to try again. 

Number to guess is 7 

I'm guessing 3 

I'm guessing 0 

I'm guessing 9 

Player one guessed 3 

Player two guessed 0 

Player three guessed 9 

Players will have to try again. 

Number to guess is 7 
I'm guessing 7 
I'm guessing 5 
I'm guessing 0 
Player one guessed 7 
Player two guessed 5 
Player three guessed 0 
We have a winner! 

Player one got it right? true 
Player two got it right? false 
Player three got it right? false 
Game is over. 
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classes and objects 


fJierei£irejio 

Dumb Questions 

What if I need global 
variables and methods? How 
do I do that if everything has to 
go in a class? 

A- 

Jr \* There isn’t a concept of 
'global’variables and methods in 
a Java 00 program. In practical 
use, however, there are times 
when you want a method (or 
a constant) to be available 
to any code running in any 
part of your program.Think 
of the random () method in 
the Phrase-O-Matic app; it's a 
method that should be callable 
from anywhere. Or what about 
a constant like p/7 You’ll learn 
in chapter 10 that marking 
a method as public and 
static makes it behave much 
like a 'global’. Any code, in any 
class of your application, can 
access a public static method. 
And if you mark a variable as 
public, static, and final 
- you have essentially made a 
globally-available constant. 

Then how is this object- 
oriented if you can still make 
global functions and global 
data? 

A, 

Jr \ m First of all, everything 
in Java goes in a class. So the 
constant for pi and the method 
for random (), although both 
public and static, are defined 
within the Math class. And you 
must keep in mind that these 
static (global-like) things are the 
exception rather than the rule 
in Java.They represent a very 
special case, where you don’t 
have multiple instances/objects. 


What is a Java progra 
What do you actually delivei 

A. 

A Java program is a pi 
of classes (or at least one das 
In a Java application, one of 
the classes must have a main 
method, used to start-up the 
program. So as a programme 
you write one or more classe 
And those classes are what y< 
deliver. If the end-user doesn 
have a JVM, then you’ll also 
need to include that with 
your application’s classes, 
so that they can run your 
program.There are a number 
of installer programs that 
let you bundle your classes 
with a variety of JVM’s (say, for 
different platforms), and put it all 
on a CD-ROM.Then the end-user 
can install the correct version of 
the JVM (assuming they don’t 
already have it on their machine.) 


What if I have a hundred 
classes? Or a thousand? Isn’t 
that a big pain to deliver 
all those individual files? 

Can I bundle them into one 
Application Thing? 


Ava is 

P 3ss 




j a i _ y \ 

■mu 




wai-tO 

•^o-ti-PyO 






(ho(olate Chip Cookie^ 

1. (tj 1QH& (h0(0l3t? (ti'lp5 



’: 广 . 


A ： 


Yes, it would be a big 
pain to deliver a huge bunch of 
individual files to your end-users, 
but you won’t have to. You can 
put all of your application files 
into a Java Archive - a .jar file - 
that’s based on the pkzip format. 
In the jar file, you can include 
a simple text file formatted as 
something called a ma/i/fesf, that 
defines which class in that jar 
holds the main() method that 
should run. 


A 


If 




BULLET POI 




m 


Object-oriented programming lets you extend 
a program without having to touch previously- 
tested, working code. 

All Java code is defined in a class. 

A class describes how to make an object of 
that class type. A class is like a blueprint. 

An object can take care of itself; you don’t 
have to know or care how the object does it. 

An object knows things and does things. 

Things an object knows about itself are called 
instance variables. They represent the state 
of an object. 

Things an object does are called methods. 
They represent the behavior of an object. 

When you create a class, you may also want 
to create a separate test class which you’ll 
use to create objects of your new class type. 

A class can inherit instance variables and 
methods from a more abstract superclass. 

At runtime, a Java program is nothing more 
than objects ‘talking’ to other objects. 
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exercise: Be the Compiler 




BE 如 compiler 

Each of {he Java files on llus pa^e 
represents a complete source file. 
Your job is to play compiler and 

determine whetiier each of 
tiiese files will compile. 
If {key won't compile, 
how would you fix tiiem, 
and if they do compile, 
what would he tiieir output? 



A 

class TapeDeck { 


boolean canRecord = false; 
void playTape() { 

System.out.println( /y tape playing"); 

} 

void recordTape() { 

System.out.println( /y tape recording"); 


class TapeDeckTestDrive { 

public static void main(String [] args) { 

t.canRecord = true; 
t.playTape(); 

if (t.canRecord == true) { 
t.recordTape(); 


B 

class DVDPlayer { 

boolean canRecord = false; 
void recordDVD() { 

System.out.println( W DVD recording"); 


class DVDPlayerTestDrive { 

public static void main(String [] args) { 

DVDPlayer d = new DVDPlayer(); 
d.canRecord = true; 
d.playDVD(); 

if (d.canRecord == true) { 
d.recordDVD(); 
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Code Magnets 

A Java program is all scrambled up on 
the fridge. Can you reconstruct the 
code snippets to make a working Java 
program that produces the output listed 
below? Some of the curly braces fell on 
the floor and they were too small to pick 
up, so feel free to add as many of those 
as you need. 




public static void main(String [] args) { 


I File Edit Window Help Dance 


% java DrumKitTestDrive 
bang bang ba-bang 
ding ding da-ding 



class DrumKit { 
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puzzle: Pool Puzzle 



P 祕 1 puzz]c 



Your job is to take code snippets from 
the pool and place them into the 
blank lines in the code. You may 
use the same snippet more than 
once, and you won’t need to use 
all the snippets. Your goal is to 
make classes that will compile and 
run and produce the output listed. 


Output 

i File Edit Window Help Implode 


% java EchoTestDrive 
helloooo... 
helloooo... 
helloooo... 
helloooo... 

10 


Bonus Question! 

If the last line of output was 
24 instead of 10 how would 
you complete the puzzle ? 


public class EchoTestDrive { 

public static void main(String [] args) { 
Echo el = new Echo(); 


int x = 0; 

while ( _ 

el.hello(); 


if ( _ ) { 

e2.count = e2.count + 1; 

} 

if ( _ ) { 

e2.count = e2.count + el.count; 

} 

X = x + 1 ； 

} 

System.out.printIn(e2.count); 


class 

{ 

int 

= o ； 

void 

{ 

System.out.println("helloooo..."); 

} 

} 



el; 

new Echo() 




Note: Each snippet 
from the pool can be 
used more than once! 


/ //^ x 

x < 4 



/M y 

x < 5 

Echo 


e2 

x > 0 

Tester 


count 

x> 1 

echo() 

e2 = el; 

el = el +1; 


count() 

Echo e2; 

el = count + 1; 


hello() 

Echo e2 

el .count = count + 1; 



Echo e2 

el .count = el .count + 1; 
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A bunch of Java components, in full costume, are playing a party 
game,"Who am W They give you a due, and you try to guess who 
they are, based on what they say. Assume they always tell the truth 
about themselves. If they happen to say something that could be true 
for more than one of them, choose all for whom that sentence can 
apply. Fill in the blanks next to the sentence with the names of one or 
more attendees.The first one’s on us. 


Tonight's attendees: 

Class Method 


Object Instance variable 


am compiled from a .java file. 

My instance variable values can 
be different from my buddy’s 
values. 


dlass 


I behave like a template. 

I like to do stuff. 

I can have many methods. 

I represent ‘state’. 

I have behaviors. 

I am located in objects. 

I live on the heap. 

I am used to create object instances. 
My state can change. 

I declare methods. 

I can change at runtime. 
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Exercise Solutions 


Code Magnets ： 

class DrumKit { 

boolean topHat = true; 
boolean snare = true; 


Be the Compiler ： 

class TapeDeck { 

boolean canRecord = false; 
void playTape() { 

System.out.println( w tape playing"); 

A } 

void recordTape() { 

System.out.println(tape recording"); 


class TapeDeckTestDrive { 

public static void main(String [] args) { 

TapeDeck t = new TapeDeck(); 

t.canRecord = true; 
t.playTape(); 


void playTopHat() { 

System, out. println ( yy ding ding da-ding 〃）； 

} 

void playSnare() { 

System, out. println ( yy bang bang ba-bang ”）； 


class DrumKitTestDrive { 

public static void main(String [] args) { 

DrumKit d = new DrumKit(); 
d.playSnare(); 
d.snare = false; 
d.playTopHat(); 

if (d.snare == true) { 
d.playSnare(); 


I File Edit Window Help Dance 


% java DrumKitTestDrive 
bang bang ba-bang 
ding ding da-ding 


if (t.canRecord == true) { 
t.recordTape(); 


We've got the template, now we have 
to make an object! 


class DVDPlayer { 

boolean canRecord = false; 
void recordDVD() { 

System.out.println( W DVD recording"); 

} 

void playDVD () { 

System.out.printlnfDVD playing"); 


class DVDPlayerTestDrive { 

public static void main(String [] args) 
DVDPlayer d = new DVDPlayer(); 
d.canRecord = true; 
d.playDVD(); 

if (d.canRecord == true) { 
d.recordDVD(); 


The line ： d.playDVD(); wouldn't 
compile without a method ! 


{ 
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puzzle Solutions 


Pool Puzzle 

public class EchoTestDrive { 

public static void main(String [] args) { 
Echo el = new Echo(); 

Echo e2 = new Echo(); // the correct answer 
- or - 

Echo e2 = el; // is the bonus answer! 

int x = 0; 
while ( X < 4 ) { 
el.hello(); 

el.count = el.count + 1; 
if ( X == 3 ) { 

e2.count = e2.count + 1; 

} 

if ( X > 0 ) { 

e2.count = e2.count + el.count; 

} 

X = X + 1; 

} 

System.out.println(e2.count); 


class Echo { 
int COUnt = 0; 
void hello() { 

System.out.println("helloooo" •"); 


m l? 


I am compiled from a .java file. 

My instance variable values can be 
different from my buddy’s values. 

I behave like a template. 

I like to do stuff. 

I can have many methods. 

I represent * state*. 


dlass 


objcdt 

dlass 

objcdt ； me 七 hod 
dlass, objedt 
•mstandc variable 


I have behaviors. 

I am located in objects. 
I live on the heap. 


objedt ； dlass 

你 c 七 hod, mstandc variable 


objedt 


I am used to create object 
instances. dlass 


My state can change. 

I declare methods. 

I can change at runtime. 


objedt, •mstaMc vav-iablc 
dlass 

objedt, instandc vav-iablc 


Note ： both classes and objects are said to have state and behavior. 
They're defined in the class, but the object is also said to 'have' 
them. Right now, we don't care where they technically live. 


File Edit Window Help Assimilate 


% java EchoTestDrive 
helloooo... 
helloooo... 
helloooo... 
helloooo... 

10 
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3 primitives and references 


Know Your Variables 



nr 




yzi 


时吻 ftm 


^nts 


°^3 y = x + 3 ； 


Variables come in two flavors: primitive and reference. So far you’ve 

used variables in two places — as object state (instance variables), and as local variables 
(variables declared within a method). Later, we’ll use variables as arguments (values sent to a 
method by the calling code), and as return types (values sent back to the caller of the method). 
You’ve seen variables declared as simple primitive integer values (type int). You’ve seen 
variables declared as something more complex like a String or an array. But there’s gotta be 
more to life than integers. Strings, and arrays. What if you have a PetOwner object with a Dog 
instance variable? Or a Car with an Engine? In this chapter we’ll unwrap the mysteries of Java 
types and look at what you can declare as a variable, what you can put in a variable, and what you 
can do with a variable. And we’ll finally see what life is truly like on the garbage-collectible heap. 
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declaring a variable 


Peclarmg a variable 



Java cares about type. It won’t let you do 

something bizarre and dangerous like stuff a 
Giraffe reference into a Rabbit variable — what 
happens when someone tries to ask the so-called 
Rabbit to hop () ? And it won’t let you put a 
floating point number into an integer variable, 
unless you acknowledge to the compiler that you 
know you might lose precision (like, everything 
after the decimal point). 

The compiler can spot most problems: 

Rabbit hopper = new Giraffe(); 

Don’t expect that to compile. Thankfully. 


For all this type-safety to work, you must declare 
the type of your variable. Is it an integer? a Dog? 
A single character? Variables come in two flavors: 
primitive and object reference. Primitives hold 
fundamental values (think: simple bit patterns) 
including integers, booleans, and floating point 
numbers. Object references hold, well, references 
to objects (gee, didn’t that clear it up.) 

We’ll look at primitives first and then move 
on to what an object reference really means. 

But regardless of the type, you must follow two 
declaration rules: 


variables must have a type 

Besides a type, a variable needs a name, so that 
you can use that name in code. 


variables must have a name 


int count 







Note: When you see a statement like: “an object 
of type X”，think of type and class as synonyms. 
(We’ll refine that a little more in later chapters.) 
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primitives and references 


Td like a double mocha, wo, make it an mt." 

When you think of Java variables, think of cups. Coffee cups, tea cups, giant 
cups that hold lots and lots of beer, those big cups the popcorn comes in at 
the movies, cups with curvy, sexy handles, and cups with metallic trim that 
you learned can never, ever go in the microwave. 

A variable is just a cup. A container. It holds something. 

It has a size, and a type. In this chapter, we’re going to look first at the 
variables (cups) that hold primitives, then a little later we’ll look at cups 
that hold references to objects. Stay with us here on the whole cup analogy — as 
simple as it is right now, it’ll give us a common way to look at things when 
the discussion gets more complex. And that’ll happen soon. 





small short tall grande 


Primitives are like the cups they have at the coffeehouse. If you’ve been to a 
Starbucks, you know what we’re talking about here. They come in different 
sizes, and each has a name like ‘short’ ， ‘tall’ ， and, “I’d like a 
‘grande’ mocha half-caff with extra whipped cream”. 

You might see the cups displayed on the counter, 
so you can order appropriately: 






And in Java, primitives come in different sizes, and those sizes 
have names. When you declare a variable in Java, 

you must declare it with a specific type. The 
four containers here are for the four 
integer primitives in Java. 


long int short byte 


Each cup holds a value, so for Java primitives, rather than saying, “I’d like a 
tall french roast”，you say to the compiler, “I’d like an int variable with the 
number 90 please.” Except for one tiny difference... in Java you also have to 
give your cup a name. So it’s actually, “I’d like an int please, with the value 
of 2486, and name the variable height: Each primitive variable has a fixed 
number of bits (cup size). The sizes for the six numeric primitives in Java 



byte short int 

8 16 32 


long 

64 


float double 

32 64 


Primitive Types 

Type Bit Depth Value Range 

boolean and char 

boolean (jvM-specmc) true or false 
char 16 bits 0 to 65535 

numeric (all are signed) 

integer 


byte 

8 bits 

-128 to 127 

short 

16 bits 

-32768 to 
32767 

int 

32 bits 

-2147483648 



to 2147483647 

long 

64 bits 

-huge to huge 

floating point 


float 

32 bits 

varies 

double 

64 bits 

varies 


Primitive declarations 
with assignments: 

int x; 

x = 234; 

byte b = 89; 

boolean isFun = true; 

double d = 3456.98; 

char c = 'f ’； 

int z = x; 

boolean isPunkRock; 
isPunkRock = false; 
boolean powerOn; 
powerOn = isFun; 
long big = 3456789; 
float f = 32.5f; 

ks 

\s 


一山 


you are here ► 51 






primitive assignment 


You really don't wawt to spill that. 

Be sure the value can fit into the variable. 



You can^ put a large value into a 
small cup. 

Well, OK, you can, but you’ll 
lose some. You’ll get, as we say, 
spillage. The compiler tries to 
help prevent this if it can tell 
from your code that something’s 
not going to fit in the container 
(variable/cup) you’re using. 

For example, you can’t pour an 
int-full of stuff into a byte-sized 
container, as follows: 

int x = 24; 

byte b = x; 

// won't work!! 


Why doesn’t this work, you ask? After all, the value of x is 24, and 24 is definitely 
small enough to fit into a byte. You know that, and we know that, but all the 
compiler cares about is that you’re trying to put a big thing into a small thing, 
and there’s the possibility of spilling. Don’t expect the compiler to know what the 
value of x is, even if you happen to be able to see it literally in your code. 

You can assign a value to a variable in one of several ways including: 

■ type a literal after the equals sign (x=/2, isGood = true, etc.) 

■ assign the value of one variable to another (x = y) 

■ use an expression combining the two (x = y + 43) 

In the examples below, the literal values are in bold italics: 


int size = 32 ; 
char initial = ' ; 

double d = 456 . 709 ; 
boolean isCrazy; 
isCrazy = true; 
int y = x + 456 ; 


declare an int named size, assign it the value 32 

declare a char named initial, assign it the value y’ 

declare a double named d, assign it the value 456.709 

declare a boolean named isCrazy (no assignment) 

assign the value true to the previously-declared isCrazy 

declare an int named y, assign it the value that is the sum 
of whatever x is now plus 456 


■ci^krpen your pencil 


The compiler won’t let you put 
a value from a large cup into 
a small one. But what about 
the other way — pouring a 
small cup into a big one? No 
problem. 

Based on what you know 
about the size and type of the 
primitive variables, see if you 
can figure out which of these 
are legal and which aren’t. 

We haven’t covered all the 
rules yet, so on some of these 
you’ll have to use your best 
judgment. Tip: The compiler 
always errs on the side of 
safety._ 


From the following list. Circle 
the statements that would be 
legal if these lines were in a 
single method: 


1 . 

int x = 

34.5; 

2. 

boolean 

boo = 

3. 

int g = 

17; 

4. 

int y = 

g ； 

5. 

y = y + 

10; 

6. 

short s 

• 

r 

7. 

s = y; 


8. 

byte b 

= 3; 

9. 

byte v 

=b; 

10 

.short 

n = 12 


11. v = n; 

12. byte k = 128; 
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primitives and references 


Pack away from that keyword! 

You know you need a name and a type for your variables. 

You already know the primitive types. 

But what can you use as names? The rules are simple. You 
can name a class, method, or variable according to the 
following rules (the real rules are slightly more flexible, 
but these will keep you safe) : 

■ It must start with a letter, underscore (_), or 
dollar sign ($). You can’t start a name with a 
number. 

■ After the first character, you can use numbers as 
well. Just don’t start it with a number. 

■ It can be anything you like, subject to those two 
rules, just so long as it isn’t one of Java’s reserved 
words. 


Oa^ ,s 









Do9 s 


are keywords (and other things) that the compiler recognizes. 
And if you really want to play confuse-a-compiler, then just try 
using a reserved word as a name. 

You’ve already seen some reserved words when we looked at 
writing our first main class: ^ , 

^ fc htuSc 


二 ㈣ P，〆 

R C 一 B 一 


j t '" stick even 

D 一 


better. 


you\r 



public static void r OVv >i 

And the primitive types are reserved as well: 

boolean char byte short int long float double 

But there are a lot more we haven’t discussed yet. Even if you don’t 
need to know what they mean, you still need to know you can’t use 
'em yourself. Do not-under any circumstances-try to memorize these 
now. To make room for these in your head, you’d probably have to 
lose something else. Like where your car is parked. Don’t worry, by 
the end of the book you’ll have most of them down cold. 




This table reserved. 



boolean 

byte 

char 

double 

float 

int 

long 

short 

public 

private 

protected 

abstract 

final 

native 

static 

strictfp 

synchronized 

transient 

volatile 

if 

else 

do 

while 

switch 

case 

default 

for 

break 

continue 

assert 

class 

extends 

implements 

import 

instanceof 

interface 

new 

package 

super 

this 

catch 

finally 

try 

throw 

throws 

return 

void 

const 

goto 

enum 


Java’s keywords and other reserved words (in no useful order). If you use these for names, the compiler will be very, very upset. 
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object references 


Controlling your Pog object 

You know how to declare a primitive variable and assign it a 
value. But now what about non-primitive variables? In other 
words, what about objects ? 


■ There is actually no such thing as an object variable. 

■ There’s only an object reference variable. 


Dog d = new Dog(); 
d.bark(); 

V 

七 hmk of 七 his 



An object reference variable holds bits that represent a 
way to access an object. 

It doesn’t hold the object itself, but it holds something 
like a pointer. Oran address. Except, in Java we don’t 
really know what is inside a reference variable. We do 
know that whatever it is, it represents one and only one 
object. And the JVM knows howto use the reference to 
get to the object. 


丄 L: 


You can’t stuff an object into a variable. We often think of 
it that way... we say things like, “I passed the String to the 
System.out.println() method.” Or, “The method returns a Dog ”， 
or，“I put a new Foo object into the variable named myFoo.” 


But that’s not what happens. There aren’t giant 
expandable cups that can grow to the size of any 
object. Objects live in one place and one place 
only — the garbage collectible heap! (You’ll 
learn more about that later in this chapter.) 


B Poj \rcmo*tc 乙 oirrbrol. 

^/ou use i*t *to yt 

*to do somc*tiimg 
(invoke methods). 


Although a primitive variable is full of 
bits representing the actual value of the 
variable, an object reference variable is full 
of bits representing a way to get to the 
object. ^ 


You use the dot operator (.) 
on a reference variable to say, 

“use the thing before the dot to 

get me the thing after the dot.” For 

example: 


Thmk o( B Poj 

variable as 


myDog.bark(); 


means, “use the object referenced by the variable myDog to 
invoke the bark() method.” When you use the dot operator on 
an object reference variable, think of it like pressing a button 
on the remote control for that object. 
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byte short int long reference 

8 16 32 64 (bit depth not relevant) 

Aw object reference is just 
another variable value. 

Something that goes in a cup. 

Only this time, the value is a remote control. 





Primitive Variable 

byte x = 7; 

The bits representing 7 go 
into the variable. (00000111). 



Reference Variable 

Dog myDog = new Dog(); 

The bits representing a way to get to 
the Dog object go into the variable. 

The Dog object itself does not go into 
the variable! 



value 


Dog 


With primitive variables, the value of the vari¬ 
able is... the value (5, -26.7, ’a’). 

With reference variables, the value of the 
variable is... bits representing a way to get to 
a specific object 

You don’t know (or care) how any particular 
JVM implements object references. Sure, they 
might be a pointer to a pointer to... but even 
if you know, you still can’t use the bits for 
anything other than accessing an object. 


We don’t care how many 1’s and 0’s there are in a reference variable.It's up to each 
JVM and the phase of the moon. 


The 3 steps of object 
declaration, creation and 
assignment 



Dog myDog 


2 

3 

=new Dog(); 


O Declare a reference 
variable 


Dog myDog = new Dog (); 

Tells the JVM to allocate space for a 
reference variable, and names that 
variable myDog.The reference variable 
is, forever, of type Dog. In other words, 
a remote control that has buttons to 
control a Dog, but not a Cat or a Button 
or a Socket. 



❺ Create an object 

Dog myDog = new Dog (); 

Tells the JVM to allocate space for a 
new Dog object on the heap (we’ll 
learn a lot more about that process, 
especially in chapter 9.) 

Dog object 



❺ 


Link the object 
and the reference 


Dog myDog = new Dog(); 

Assigns the new Dog to the reference 
variable myDog. In other words, 

programs the remote control. 




Dog object 


fiyDof 


Dog 


you are here 
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I ^(ierei£ire^no 

Dumb Questions 

How big is a reference 
variable? 

You don't know. Unless 
you’re cozy with someone on the 
JVM’s development team, you 
don’t know how a reference is 
represented.There are pointers 
in there somewhere, but you 
can’t access them. You won’t 
need to. (OK, if you insist, you 
might as well just imagine it 
to be a 64-bit value.) But when 
you’re talking about memory 
allocation issues,your Big 
Concern should be about how 
many objects (as opposed to 
object references) you're creating, 
and how big they (the objects) 
really are. 


So, does that mean that 
all object references are the 
same size, regardless of the size 
of the actual objects to which 
they refer? 


Yep. All references for a 
given JVM will be the same 
size regardless of the objects 
they reference, but each JVM 
might have a different way of 
representing references, so 
references on one JVM may be 
smaller or larger than references 
on another JVM. 


^^•Can I do arithmetic on a 
reference variable, increment it, 
you know - C stuff? 

Nope. Say it with me again, 
"Java is not C 〃 



^Java Ex^osedi 

This week’s interview: 
Object Reference 


Head First： So, tell us, what’s life like for an object reference? 

Reference： Pretty simple, really. I’m a remote control and I can be programmed to 
control different objects. 

Head First: Do you mean different objects even while you’re running? Like, can you 
refer to a Dog and then five minutes later refer to a Car? 

Reference： Of course not. Once I’m declared, that’s it. If I’m a Dog remote control 
then I’ll never be able to point (oops — my bad, we’re not supposed to sw/point) I mean refer 
to anything but a Dog. 

Head First： Does that mean you can refer to only one Dog? 

Reference： No. I can be referring to one Dog, and then five minutes later I can refer to 
some other Dog. As long as it’s a Dog, I can be redirected (like reprogramming your remote 
to a different TV) to it. Unless... no never mind. 

Head First： No, tell me. What were you gonna say? 

Reference： I don’t think you want to get into this now, but I’ll just give you the short 
version — if I’m marked as final, then once I am assigned a Dog, I can never be repro¬ 
grammed to anything else but that one and only Dog. In other words, no other object can 
be assigned to me. 

Head First： You’re right, we don’t want to talk about that now. OK, so unless you’re 
final, then you can refer to one Dog and then refer to a different Dog later. Can you ever 
refer to nothing at all? Is it possible to not be programmed to anything? 

Reference： Yes, but it disturbs me to talk about it. 

Head First: Why is that? 

Reference： Because it means I’m null, and that’s upsetting to me. 

Head First： You mean, because then you have no value? 

Reference： Oh, null £s~a value. I’m still a remote control, but it’s like you brought 
home a new universal remote control and you don’t have a TV I’m not programmed to 
control anything. They can press my buttons all day long, but nothing good happens. I 
just feel so... useless. A waste of bits. Granted, not that many bits, but still. And that’s not 
the worst part. If I am the only reference to a particular object, and then I’m set to null 
(deprogrammed), it means that now nobody can get to that object I had been referring to. 

Head First： And that’s bad because... 

Reference： You have to ask? Here I’ve developed a relationship with this object, an 
intimate connection, and then the tie is suddenly, cruelly, severed. And I will never see 
that object again, because now it’s eligible for [producer, cue tragic music] garbage collection. 
Sniff. But do you think programmers ever consider that? Snif. Why, why can’t I be a primi¬ 
tive? I hate being a reference. The responsibility, all the broken attachments... 
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Life on the garbage-collectible heap 


Book b = new Book(); 


Book c = new Book(); 

Declare two Book reference 
variables. Create two new Book 
objects. Assign the Book objects to 
the reference variables. 

The two Book objects are now living 
on the heap. 

References: 2 

Objects: 2 


Book 


Book 


Book d = c; 

Declare a new Book reference variable. 
Rather than creating a new, third Book 
object, assign the value of variable c to 
variable d. But what does this mean? 

It’s like saying,''Take the bits in c, make a 
copy of them, and stick that copy into d." 

Both c and d refer to the same 
object. 

The c and d variables hold 
two different copies of the 
same value. Two remotes 
programmed to one TV. 

References: 3 

Objects: 2 



Book 


c = b; 

Assign the value of variable b to 
variable c. By now you know what 
this means.The bits inside variable 
b are copied, and that new copy is 
stuffed into variable c. 

Both b and c refer to the 
same object. 

References: 3 

Objects: 2 
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objects on the heap 


Life ahd death on the heap 

Book b = new Book(); 

Book c = new Book(); 

Declare two Book reference variables. 
Create two new Book objects. Assign 
the Book objects to the reference 
variables. 

The two book objects are now living 
on the heap. 

Active References: 2 

Reachable Objects: 2 



Book 


Book 



b = c; 

Assign the value of variable c to variable b. 
The bits inside variable c are copied, and 
that new copy is stuffed into variable b. 
Both variables hold identical values. 

Both b and c refer to the same 
object. Object 1 is abandoned 
and eligible for Garbage Collec¬ 
tion (GC). 

Active References: 2 

Reachable Objects: 1 

Abandoned Objects: 1 

The first object that b referenced, Object 1, 
has no more references. It’s unreachable. 





Q. 


ro 

Qj 

C 


Book 


/ 


/ 


7 ^ 


Book 


c = null; 

Assign the value null to variable c. 
This makes c a null reference, meaning 
it doesn’t refer to anything. But it’s still 
a reference variable, and another Book 
object can still be assigned to it. 

Object 2 still has an active 
reference (b)，and as long 
as it does, the object is not 
eligible for GC. 

Active References: 1 

null References: 1 

Reachable Objects: 1 

Abandoned Objects: 1 



Book 
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Aw array is like a tray of cups 

© Declare an int array variable. An array variable is 
a remote control to an array object. 

int [] nums; 




Create a new int array with a length 
of 7, and assign it to the previously- 
declared int [ ] variable nums 

nums = new int[7]; 


Give each element in the array 
an int value. 

Remember, elements in an int 
array are just int variables. 


nums [ 0 ] 
nums [ 1 ] 
nums [2] 
nums [ 3 ] 
nums [ 4 ] 
nums [ 5 ] 
nums [6] 


6 ; 

19 
44 
42 
10 

20 
1； 


int array object (int[]) 


int[] 


Notice 七 array itscl-f is object 
-though -the 1 deirwey\*b arc prirwi-tives. 


Arrays arc objects too 

The Java standard library includes 
lots of sophisticated data structures 
including maps, trees, and sets 
(see Appendix B), but arrays are 
great when you just want a quick, 
ordered, efficient list of things. 
Arrays give you fast random 
access by letting you use an index 
position to get to any element in 
the array. 

Every element in an array is just 
a variable. In other words, one of 
the eight primitive variable types 
(think: Large Furry Dog) or a 


reference variable. Anything you 
would put in a variable of that type 
can be assigned to an array element 
of that type. So in an array of type 
int (int[]) ， each element can hold 
an int. In a Dog array (Dog[]) each 
element can hold... a Dog? No, 
remember that a reference variable 
just holds a reference (a remote 
control), not the object itself. So 
in a Dog array, each element can 
hold a remote control to a Dog. Of 
course, we still have to make the 
Dog objects... and you’ll see all that 
on the next page. 


Be sure to notice one key thing 
in the picture above - the array is 
an object, even though it’s an array of 
primitives. 

Arrays are always objects, whether 
they’re declared to hold primitives 
or object references. But you can 

have an array object that’s declared 
to hold primitive values. In other 
words, the array object can have 
elements which are primitives, but 
the array itself is never a primitive. 
Regardless of what the array holds, 
the array itself is always an object! 
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an array of objects 

Make an array of Pogs 



O Declare a Dog array variable 
Dog[] pets; 


© Create a new Dog array with 
a length of 1, and assign it to 
the previously-declared Dog [] 
variable pets 

pets = new Dog[7]; 


Dog array object (Dog[]) 


Whafs missing? 

Dogs! We have an array 
of Dog references, but no 
actual Dog objects'. 


Dog[] 



Create new Dog objects, and 
assign them to the array 
elements. 

Remember, elements in a Dog 
array are just Dog reference 
variables. We still need Dogs! 


pets[0] 
pets[1] 


new Dog(); 
new Dog(); 


-(iQ^^irp6n your pencil — 


What is the current value of 
pets[2]?_ 

What code would make 
pets[3] refer to one of the 
two existing Dog objects? 


0og[] 


ob v/e C/ 


Dog array object (Dog[]) 
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name 


bark() 

eat() 

chaseCat() 




java cares about type. 

0nce you've declared an array, you 

For exa ^ P ， e ui J°bep^ 
array (it would b ^P Y . the array , so 

thinks that only D °9 S are Qnd then to their 
they lurking.) And 

h °^lfstick a double into an int array 
you cant stick however ， 

(spillage, remember?) You can, q 

put a byte into a " ； .f +n a ；： 7nV-5 cup. 

byte willalwc^t=3 widening . Wd 
This is known as an f or nov ? just 

get 巧 the deta.1 5 ^ “: r won . t let you 

- - array, based on 

the array's declared type. 


Control your Pog 

(with a reference variable) 

Dog fido = new Dog(); 

fido.name = 、 'Fido ”； 

We created a Dog object and 
used the dot operator on the 
reference variable fido to access 
the name variable.* 

We can use the fido reference 
to get the dog to bark () or 
eat() or chaseCat(). 

fido. bark (); 

fido. chaseCat (); 



Dog 


What happens if the Pog is iw 
a Pog array? 

We know we can access the Dog’s 
instance variables and methods using 
the dot operator, but on what? 

When the Dog is in an array, we don’t 
have an actual variable name (like 
fido). Instead we use array notation and 
push the remote control button (dot 
operator) on an object at a particular 
index (position) in the array: 

Dog[] myDogs = new Dog[3]; 

myDogs[0] = new Dog(); 

myDogs [ 0 ] . name = 、 'Fido"; 

myDogs[0].bark(); 


*Yes we know we’re not demonstrating encapsulation here, but we’re 
trying to keep it simple. For now. Well do encapsulation in chapter 4. 
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using references 


class Dog { 

String name; 

public static void main (String[] args) { 

// make a Dog object and access it 

Dog dogl = new Dog(); 

dogl.bark(); 

dogl. name = ''Bart ”； 

// now make a Dog array 

Dog[] myDogs = new Dog[3]; 

// and put some dogs in it 
myDogs[0] = new Dog(); 
myDogs[1] = new Dog(); 
myDogs[2] = dogl; 

// now access the Dogs using the array 
// references 

myDogs [ 0 ]. name = ''Fred ”； 
myDogs [ 1 ]. name 二 ''Marge"; 

// Hmmmm... what is myDogs[2] name? 

System. out. print (''last dog's name is ; 
System.out.println(myDogs[2].name); 

// now loop through the array 
// and tell all dogs to bark 



public void bark() { 

System. out. println (name +、' says Ruff!"); 

} 

public void eat () { } 

public void chaseCat() { } 


A Pog example 

Dog 


name 


bark() 

eat() 

chaseCat() 


Output 


% java Dog 
null says Ruff! 
last dog's name is Bart 
Fred says Ruff! 

Marge says Ruff! 

Bart says Ruff! 


—— BULLET POINTS - 

■ Variables come in two flavors: primitive and 
reference. 

■ Variables must always be declared with a name 
and a type. 

■ A primitive variable value is the bits representing 
the value (5, l a\ true, 3.1416, etc.). 

■ A reference variable value is the bits 
representing a way to get to an object on the 
heap. 

■ A reference variable is like a remote control. 
Using the dot operator (■) on a reference 
variable is like pressing a button on the remote 
control to access a method or instance variable. 

■ A reference variable has a value of null when 
it is not referencing any object. 

■ An array is always an object, even if the array 
is declared to hold primitives. There is no such 
thing as a primitive array, only an array that 
holds primitives. 
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EmclSd 



BE 如 compiler 

EacK of the Java files on lliis pa^e 
represents a complete source file. 
Your job is to play compiler and 
determine wh&6rev each of these files 
will compile. If tiiey won’t 
compile, how would you 

fix {ken? 



A 

class Books { 

String title; 
String author; 


class BooksTestDrive { 

public static void main(String [] args) { 


Books [] myBooks = new Books[3]; 
int x = 0; 


myBooks[0].title = 
myBooks[1].title = 
myBooks[2].title = 
myBooks[0].author = 
myBooks[1].author = 
myBooks[2].author = 


"The Grapes of Java"; 
"The Java Gatsby"; 
"The Java Cookbook"; 
"bob"; 

"sue"; 

"ian"; 


while (x < 3) { 

System.out.print(myBooks[x].title); 
System.out.print( w by "); 

System.out.println(myBooks[x].author); 
x = x + 1; 


B 

class Hobbits { 

String name; 

public static void main(String [] args) { 

Hobbits [] h = new Hobbits[3]; 
int z = 0; 


while (z < 4) { 
z = z + 1; 

h[z] = new Hobbits(); 
h[z].name = "bilbo"; 
if (z == 1) { 

h[z].name = "frodo"; 

} 

if (z == 2) { 

h[z].name = "sam"; 

} 

System.out.print(h[z].name + " is a "); 
System.out.println("good Hobbit name〃）； 
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exercise: Code Magnets 




Code Magnets 

A working Java program is all scrambled up 
on the fridge. Can you reconstruct the code 
snippets to make a working Java program 
that produces the output listed below? 
Some of the curly braces fell on the floor 
and they were too small to pick up, so feel 
free to add as many of those as you need! 




System.out.println(islands[ref]); 




File Edit Window Help Bikini 


% java TestArrays 
island = Fiji 
island = Cozumel 
island = Bermuda 
island = Azores 


class TestArrays { 


public static void main(String 


f] args) { 


64 

























primitives and references 



P 錢 I puzz]c 



Your job is to take code snippets from 
the pool and place them into the 
blank lines in the code. You may 
use the same snippet more than 
once, and you won’t need to use 
all the snippets. Your goal is to 
make a class that will compile and 
run and produce the output listed. 


class Triangle { 
double area; 
int height; 
int length; 


a scyavatc 








public static void main(String [] args) { 


while 


.height = (x + 1) * 2; 
.length = x + 4; 


Output 


File Edit Window Help Bermuda 


% java Triangle 
triangle 0 , area = 4.0 
triangle 1 , area = 10.0 
triangle 2, area = 18.0 
triangle 3, area = _ 

y =_ 


Bonus Question! 

For extra bonus points, use snippets 
from the pool to fill in the missing 
output (above). 


System, out. print (triangle "+x+” ， area"); 
System. out. print In (= iJ + _.area); 


x = 27; 

Triangle t5 = ta[2]; 
ta[2].area = 343; 

System.out.print( iy y = " + y); 

System. out. print In (, t5 area = "+ t5. area); 

} 

void setArea() { 

_ = (height * length) / 2; 


Note: Each snippet 
from the pool can be 
used more than once! 
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puzzle: Heap o* Trouble 



A Heap o f Trouble 

A short Java program is listed to the 
right. When V/ do stuff’ is reached, some 
objects and some reference variables 
will have been created. Your task is 
to determine which of the reference 
variables refer to which objects. Not all 
the reference variables will be used, and 
some objects might be referred to more 
than once. Draw lines connecting the 
reference variables with their matching 
objects. 

Tip: Unless you’re way smarter than us, 
you probably need to draw diagrams 
like the ones on page 55 and 56 of this 
chapter. Use a pencil so you can draw 
and then erase reference links (the 
arrows going from a reference remote 
control to an object). 


class HeapQuiz { 

int id = 

0; 

public static void main(String [] args) { 

int x = 

0; 

HeapQuiz [ ] hq = new HeapQuiz[5]; 

while ( 

x < 3 ) { 

hq [x] 

=new HeapQuiz(); 

hq [x] 

.id = x ; 

X = X 

+ 1; 

J 

hq[3] = 

hq [1]; 

hq[4] = 

hq [1]; 

hq[3] = 

null ; 

hq[4] = 

hq [ 0 ]; 

hq[0] = 

hq [ 3 ]; 

hq[3] = 

hq[2] ; 

hq[2] = 

hq [ 0 ]; 

// do stuff 

} 

} 






to 


Reference Variables: 



hq[0] 




hq[l] 


hq[2] 




HeapQuiz Objects: 
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Five 嫌 
JVtysfery 



The case of the pilfered references 

It was a dark and stormy night. Tawny strolled into the programmers’ bullpen like she 
owned the place. She knew that all the programmers would still be hard at work, and she 
wanted help. She needed a new method added to the pivotal class that was to be loaded into the 
client’s new top-secret Java-enabled cell phone. Heap space in the cell phone’s memory was 
as tight as Tawny’s top, and everyone knew it. The normally raucous buzz in the bullpen fell to 
silence as Tawny eased her way to the white board. She sketched a quick overview of the new 
methods functionality and slowly scanned the room. “Well boys, it’s crunch time”, she purred. 
“Whoever creates the most memory efficient version of this method is coming with me to the 
client’s launch party on Maui tomorrow... to help me install the new software.” 

The next morning Tawny glided into the bullpen wearing her short Aloha dress. 
“Gentlemen”, she smiled, ''the plane leaves in a few hours, show me what you’ve 
got!”. Bob went first; as he began to sketch his design on the white board Tawny 
said, “Let’s get to the point Bob, show me how you handled updating the list of con¬ 
tact objects.” Bob quickly drew a code fragment on the board: 


Contact [] ca = new Contact[10]; 


while ( x < 10 ) { // make 10 contact objects 

ca[x] = new Contact(); 
x = x + 1 ; 

} 

// do complicated Contact list updating stuff with ca 


“Tawny I know we’re tight on memory, but your spec said that we had to be able to access 
individual contact information for all ten allowable contacts, this was the best scheme I could 
cook up”, said Bob. Kent was next, already imagining coconut cocktails with Tawny, “Bob,” 
he said, “your solution’s a bit kludgy don’t you think?” Kent smirked, “Take a look at this 
baby ”： 


Contact refc; 

while ( x < 10 ) { // make 10 contact objects 

refc = new Contact (); 
x = x + 1 ; 

} 

// do complicated Contact list updating stuff with refc 


“I saved a bunch of reference variables worth of memory, Bob-o-rino, so put away your 
sunscreen”, mocked Kent. “Not so fast Kent!”, said Tawny, “you’ve saved a little memory, but 
Bob’s coming with me.”. 


Why did Tawny choose Bob’s method over Kent’s，when Kent’s used less memory? 
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Exercise Solutions 


Code Magnets ： 


class TestArrays { 

public static void main(String [] args) { 
int [] index = new int[4]; 
index[0] = 1; 
index[1] = 3; 
index[2] = 0; 
index[3] = 2; 


String [] islands = new String[4]; 
islands[0] = "Bermuda"; 
islands[1] = "Fiji"; 
islands[2] = "Azores"; 


islands[3] = "Cozumel"; 
int y = 0; 


int ref; 


while (y < 4) { 
ref = index[y]; 

System.out.print("island ="); 
System.out.println(islands[ref]); 


y 




File Edit Window Help Bikini 


% java TestArrays 
island = Fiji 
island = Cozumel 
island = Bermuda 
island = Azores 


class Books { 

String title; 

String author; 

} 

class BooksTestDrive { 

public static void main(String [] args) { 
Books [] myBooks = new Books[3]; 


A 


int x = 0; 

myBooks[0] = new Books(); 
myBooksfl] = new Books(); 
myBooks[2] = new Books(); 

myBooks[0].title = 
myBooks[1].title = 
myBooks[2].title = 


Remember ： We have to 
actually make the Books 
objects ! 


myBooks[0].author 
myBooks[1].author 
myBooks[2].author 
while (x < 3) { 


The Grapes of Java”； 
The Java Gatsby"; 

The Java Cookbook’’； 
"bob"; 

"sue"; 

"ian”； 


System.out.print(myBooks[x].title); 
System_out.print(" by "); 

System.out.println(myBooks[x].author); 
x = x + 1; 


class Hobbits { 

String name; 

public static void main(String [] args) { 
Hobbits [] h = new Hobbits[3]; 
int z = -1; 
while (z < 2) { 
z = z + 1; 
h[z] = new Hobbits(); 

^ h[z].name = "bilbo”； 
if (z == 1) { 

h[z].name = "frodo〃； 

} 

if (z == 2) { 
h[z].name = "sam"; 

} 

System.out.print(h[z].name + " is a "); 
System.out.println( w good Hobbit name"); 


Remember ： arrays start with 
element 0 ! 
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Puzzle Solutions 


The case of the pilfered references 


class Triangle { 
double area; 
int height; 
int length; 

public static void main(String [] args) { 

int x = 0; 

Triangle [ ] ta = new Triangle[4]; 

while ( x < 4 ) { 

ta[x] = new Triangle(); 
ta[x]. height = (x + 1) * 2; 
ta[x] .length = x + 4; 

ta[x].setArea(); 

System.out .print ( /y triangle "+x+", area"); 
System.out.println( " = " + ta[x] .area); 

X = X + 1; 

} 

int y = x; 

x = 27; 

Triangle t5 = ta[2]; 
ta[2].area = 343; 

System.out .print ( /y y = " + y )； 

System.out.printIn (", t5 area = "+ t5.area); 

} 

void setArea() { 

area = (height * length) / 2; 


I File Edit Window 

Help 

Bermuda 


% java Triangle 


triangle 

0 , 

area = 

4.0 

triangle 

l, 

area = 

10.0 

triangle 

2, 

area = 

18.0 

triangle 

3, 

area = 

28.0 

y = 4, t5 area = 343 



Tawny could see that Kent’s method had a serious 
flaw. It’s true that he didn’t use as many reference 
variables as Bob, but there was no way to access any 
but the last of the Contact objects that his method cre¬ 
ated. With each trip through the loop, he was assign¬ 
ing a new object to the one reference variable, so the 
previously referenced object was abandoned on the 
heap - unreachable. Without access to nine of the ten 
objects created, Kent’s method was useless. 

(The software was a huge success and the client gave Tawny and Bob an extra week 
in Hawaii. We’d like to tell you that by finishing this book you too will get stuff like that.) 


Reference Variables: HeapQuiz Objects 
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4 methods use instance variables 


How Objects Behave 



State affects behavior, behavior affects state. We know that objects 

have state and behavior, represented by instance variables and methods. But until now, we 
haven’t looked at how state and behavior are related. We already know that each instance of a 
class (each object of a particular type) can have its own unique values for its instance variables. 
Dog A can have a name "Fido”and a weight of 70 pounds. Dog B is "Killer” and weighs 9 pounds. 
And if the Dog class has a method makeNoiseO, well, don’t you think a 70-pound dog barks a 
bit deeper than the little 9-pounder? (Assuming that annoying yippy sound can be considered 
a bark.) Fortunately, that’s the whole point of an object — it has behavior that acts on its state. In 
other words, methods use instance variable values. Like,"if dog is less than 14 pounds, make 
yippy sound, else...” or "increase weight by 5 ’： Let’s go change some state. 
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objects have state and behavior 


Remember: a class describes what an 
object kwows and what aw object dogs 


A class is the blueprint for an object. When you 
write a class, you’re describing how the JVM 
should make an object of that type. You already 
know that every object of that type can have 
different instance variable values. But what about 
the methods? 

Can every object of that type have different 
method behavior? 


instance 

variables 

(state) 

methods 

(behavior) 



knows 

does 


Well... sort of 

Every instance of a particular class has the same 
methods, but the methods can behave differently 
based on the value of the instance variables. 

The Song class has two instance variables, title 
and artist. The play() method plays a song, but 
the instance you call play() on will play the song 
represented by the value of the title instance 
variable for that instance. So, if you call the play() 
method on one instance you’ll hear the song 
“Politik”，while another instance plays “Darkstar”. 
The method code, however, is the same. 

void play() { 

soundPlayer.playSound(title); 

} 


^5 


〆 Sinatra 


DarkstarX 

Grateful 1 
Dead 


Song t2 = new Song(); 
t2 . setArtist (''Travis ”）； 
t2 . setTitle (''Sing ”）； 

Song s3 = new Song(); 

s3 . setArtist (''Sex Pistols ’’） 

s3 . setTitle (''My Way"); 





Song 

t2 .play (); 



Song 

s3.play(); 

/ 

Callih 9 o, this 
will >y Way ,1 h> play. 

ho*t -the ohc) 


*Yes, another stunningly clear answer! 
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The size affects the bark 

A small Dog’s bark is different from a big Dog’s bark. 

The Dog class has an instance variable size, that the 
bark() method uses to decide what kind of bark sound 
to make. 


class Dog { 
int size; 

String name; 

void bark() { 

if (size > 60) { 

System. out. println (''Wooof ! Wooof ! 〃）； 
} else if (size > 14) { 

System. out. println (''Ruff ! Ruff ! 〃）； 

} else { 

System. out. println (''Yip ! Yip ! 〃）； 


Dog 


size 

name 


Dar^j 


— 


class DogTestDrive { 


public static void main (String[] args) { 

Dog one = new Dog(); 
one.size = 70; 

Dog two = new Dog(); 
two.size = 8; 

Dog three = new Dog (); 
three.size = 35; 

one.bark(); 
two.bark(); 
three.bark(); 


I File Edit Window Help Playdead 


% java DogTestDrive 
Wooof! Wooof! 

Yip! Yip! 

Ruff! Ruff! 
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method parameters 


You can send things to a method 


Just as you expect from any programming language, you can pass values into 
your methods. You might, for example, want to tell a Dog object how many 
times to bark by calling: 

d.bark(3); 

Depending on your programming background and personal preferences, 
you might use the term arguments or perhaps parameters for the values passed 
into a method. Although there are formal computer science distinctions that 
people who wear lab coats and who will almost certainly not read this book, 
make, we have bigger fish to fry in this book. So you can call them whatever 
you like (arguments, donuts, hairballs, etc.) but we’re doing it like this: 

A method uses parameters. A caller passes arguments. 

Arguments are the things you pass into the methods. An argument (a value 
like 2, “Foo”，or a reference to a Dog) lands face-down into a... wait for it... 
parameter. And a parameter is nothing more than a local variable. A variable 
with a type and a name, that can be used inside the body of the method. 

But here’s the important part: If a method takes a parameter, you must pass 
it something. And that something must be a value of the appropriate type. 


o 


Call the bark method on the Dog refer¬ 
ence, and pass in the value 3 (as the 
argument to the method). 


Dog d = new Dog(); 
d.bark(3); 



H The bits re 
value 3 are 


The bits representing the int 


value 3 are delivered into the 
bark method. 




The bits land in the numOf Barks 
parameter (an int-sized variable). 


while (numOfBarks >0) { 

System, out .printIn (''ruf f 〃）； 

mimOfBarks = numOfBarks — 1 



Use the numOfBarks 
parameter as a variable in 
the method code. 
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You caw get things back from a method. 


Methods can return values. Every method is declared with a return 
type, but until now we’ve made all of our methods with a void 
return type, which means they don’t give anything back. 


void go () { 

} 

But we can declare a method to give a specific type of value 
back to the caller, such as: 

int giveSecret() { 

return 42; 



If you declare a method to return a value, you must 
return a value of the declared type! (Or a value 
that is compatible with the declared type. We’ll get 
into that more when we talk about polymorphism 
in chapter 7 and chapter 8.) 


Whatever you say 
you’ll give back, you 
better give back! 



The dompilev lc*t you vc*tu\rh *typc o-f 






int theSec 





life•giveSecret(); 



,/un av . C ^ v<>， 

㈣ lir 一 
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multiple arguments 

You can send more thaw om thing 
to a method 


Methods can have multiple parameters. Separate them 
with commas when you declare them, and separate the 
arguments with commas when you pass them. Most 
importantly, if a method has parameters, you must pass 
arguments of the right type and order. 


Calling a two - parameter method, and sendiKig 
it two arguments. 


void go () { 

TestStuff t = new TestStuff() 
t.takeTwo(12, 34); 





int z = x + y; 

System. out. println (''Total is 〃 + z); 


You can pass variables into a method, as long as 
the variable type watches the parameter type. 


void go () { 

int foo = 7; 
int bar = 3; 
t.takeTwo(foo, bar); 



int z = x + y; 

System, out.println (''Total 






IS 


z); 
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Java is pass-by-va[ug. 
That means pass - by - copy. 



int x = 7; 



o 


Declare an inr varfSoiear 
the value T. The bit pattern for 7 
goes into the variable named x. 


ana assign it 


void go(int z) { 



Declare a method with an int 
parameter named z. 






int 

foo.go(x); 


O Call the go() method, passing 
the variable x as the argument. 
The bits in x are copied, and 
the copy lands in z. 

int 

void go(int z) { } 




void go(int z){ 



Change the value of z inside 
the method. The value of x 
doesn't change! The argument 
passed to the z parameter was 
only a copy of x. 

The method can’t change the 
bits that were in the calling 
variable x. 
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arguments and return values 


^fJierei^irejio 

Dumb Questions 

^^•What happens if the argument you want to 
pass is an object instead of a primitive? 

A- 

You’ll learn more about this in later chapters, 
but you already /enow the answer. Java passes 
everything by value. Everything. But... value means 
bits inside the variable. And re member, you don’t 
stuff objects into variables; the variable is a remote 
control — a reference to an object. So if you pass a 
reference to an object into a method, you’re passing 
a copy of the remote control. Stay tuned, though, we’ll 
have lots more to say about this. 


^^•Can a method declare multiple return values? 
Or is there some way to return more than one 
value? 

A. 

^\-Sort of. A method can declare only one return 
value. BUT... if you want to return, say, three int values, 
then the declared return type can be an int array. 
Stuff those ints into the array, and pass it on back. It’s 
a little more involved to return multiple values with 
different types; we’ll be talking about that in a later 
chapter when we talk about ArrayList. 


Q^-Dol have to return the exact type I declared? 

A- 

You can return anything that can be implicitly 
promoted to that type. So, you can pass a byte where 
an int is expected.The caller won’t care, because the 
byte fits just fine into the int the caller will use for 
assigning the result. You must use an explicit cast 
when the declared type is smallerthan what you’re 
trying to return. 


Do I have to do something with the return 
value of a method? Can I just ignore it? 

^V:」ava doesn’t require you to acknowledge a 
return value. You might want to call a method with 
a non-void return type, even though you don’t care 
about the return value. In this case, you’re calling 
the method for the work it does inside the method, 
rather than for what the method gives returns. In 
Java, you don’t have to assign or use the return value. 
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Reminder: Java 
cares about type! 


RaUni 


You can’t return a Giraffe when 
the return type is declared 
as a Rabbit. Same thing with 
parameters. You can’t pass a 
Giraffe into a method that 
takes a Rabbit. 





■ 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


BULLET POINT 


Classes define what an object knows and what an 
object does. 

Things an object knows are its instance variables 
(state). 

Things an object does are its methods (behavior). 

Methods can use instance variables so that objects 
of the same type can behave differently. 

A method can have parameters, which means you 
can pass one or more values in to the method. 

The number and type of values you pass in must 
match the order and type of the parameters 
declared by the method. 

Values passed in and out of methods can be 
implicitly promoted to a larger type or explicitly cast 
to a smaller type. 

The value you pass as an argument to a method 
can be a literal value (2, ‘c’ ， etc.) or a variable of 
the declared parameter type (for example, x where 
x is an int variable). (There are other things you 
can pass as arguments, but we’re not there yet.) 

A method must declare a return type. A void return 
type means the method doesn’t return anything. 

If a method declares a non-void return type, it must 
return a value compatible with the declared return 

type. 








methods use instance variables 


Cool things you can do with parameters 
and return types 


Now that we’ve seen how parameters and return types work, it’s 
time to put them to good use: Getters and Setters. If you’re into 
being all formal about it, you might prefer to call them Accessors 
and Mutators. But that’s a waste of perfectly good syllables. 
Besides, Getters and Setters fits the Java naming convention, so 
that’s what we’ll call them. 

Getters and Setters let you, well, get and set things. Instance vari¬ 
able values, usually. A Getter’s sole purpose in life is to send back, 
as a return value, the value of whatever it is that particular Getter 
is supposed to be Getting. And by now, it’s probably no surprise 
that a Setter lives and breathes for the chance to take an argu¬ 
ment value and use it to set the value of an instance variable. 


class ElectricGuitar { 


ElectricGuitar 


brand 

numOfPickups 

rockStarUsesIt 




getBrand() 

setBrand() 

getNumOfPickups() 

setNumOfPickups() 

getRockStarUseslt() 

setRockStarUseslt() 


Note- 

JfoWovi'^ ^ 



String brand; 
int numOfPickups; 
boolean rockStarUsesIt; 


String getBrand() { 

return brand; 

} 

void setBrand(String aBrand) { 
brand = aBrand; 

} 

int getNumOfPickups() { 

return numOfPickups; 

} 

void setNumOfPickups(int num) { 
numOfPickups = num; 

} 

boolean getRockStarUsesIt() { 
return rockstarUses11; 



void setRockStarUsesIt(boolean yesOrNo) { 
rockStarUsesIt = yesOrNo; 
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real developers encapsulate 


Encapsulation 


Po it or risk humiliation and 
ridicule. 

Until this most important moment, we’ve 
been committing one of the worst OO 
faux pas (and we’re not talking minor 
violation like showing up without the ‘B’ 
in BYOB). No, we’re talking Faux Pas with 
a capital ‘F’. And ‘P’. 

Our shameful transgression? 

Exposing our data! 

Here we are, just humming along without 
a care in the world leaving our data out 
there for anyone to see and even touch. 

You may have already experienced that 
vaguely unsettling feeling that comes with 
leaving your instance variables exposed. 

Exposed means reachable with the dot 
operator, as in: 

theCat.height = 27; 

Think about this idea of using our remote 
control to make a direct change to the Cat 
object’s size instance variable. In the hands 
of the wrong person, a reference variable 
(remote control) is quite a dangerous 
weapon. Because what’s to prevent: 

theCat. height = 0; 







& 


This would be a Bad Thing. We need to 

public void setHeight(int ht) { 

build setter methods for all the instance 

if 

(ht > 9) { 

height = ht; 


variables, and find a way to force other 
code to call the setters rather than access 


the data directly. 

i 



J 

} 
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Hide the data 

Yes it is that simple to go from 
an implementation that’s just 
begging for bad data to one 
that protects your data and 
protects your right to modify 
your implementation later. 



Java Bx^osedi 


This week’s interview: 

An Object gets candid about encapsulation. 


Head First: What’s the big deal about encapsulation? 

Object: OK, you know that dream where you’re giving a talk to 500 people when you 
suddenly realize— you’re nakecR 


OK, so how exactly do you 
hide the data? With the 
public and private 
access modifiers. You’re 
familiar with public-we use 
it with every main method. 

Here’s an encapsulation 
starter rule of thumb (all stan¬ 
dard disclaimers about rules 
of thumb are in effect) : mark 
your instance variables private 
and provide public getters 
and setters for access control. 
When you have more design 
and coding savvy in Java, you 
will probably do things a little 
differently, but for now, this 
approach will keep you safe. 


Mark instance 
variables private. 

Mark getters and 
setters public. 


“Sadly, Bill forgot to 
encapsulate his Cat class and 
ended up with a flat cat." 

(overheard at the water cooler). 


Head First ： Yeah, we’ve had that one. It’s right up there with the one about the Pilates 
machine and... no, we won’t go there. OK, so you feel naked. But other than being a little 
exposed, is there any danger? 

Object ： Is there any danger? Is there any danger? [starts laughing] Hey, did all you other 
instances hear that, “Is there any danger?” he asks? [falls on the floor laughing] 

Head First ： What’s funny about that? Seems like a reasonable question. 

Object: OK, I’ll explain it. It’s [bursts out laughing again, uncontrollably] 

Head First ： Can I get you anything? Water? 

Object: Whew! Oh boy. No I’m fine, really. I’ll be serious. Deep breath. OK, go on. 
Head First: So what does encapsulation protect you from? 

Object ： Encapsulation puts a force-field around my instance variables, so nobody can set 
them to, let’s say, something inappropriate. 

Head First ： Can you give me an example? 

Object: Doesn’t take a PhD here. Most instance variable values are coded with certain 
assumptions about the boundaries of the values. Like, think of all the things that would 
break if negative numbers were allowed. Number of bathrooms in an office. Velocity of 
an airplane. Birthdays. Barbell weight. Cell phone numbers. Microwave oven power. 

Head First: I see what you mean. So how does encapsulation let you set boundaries? 

Object ： By forcing other code to go through setter methods. That way, the setter method 
can validate the parameter and decide if it’s do-able. Maybe the method will reject it and 
do nothing, or maybe it’ll throw an Exception (like if it’s a null social security number 
for a credit card application), or maybe the method will round the parameter sent in to 
the nearest acceptable value. The point is, you can do whatever you want in the setter 
method, whereas you can’t do anything if your instance variables are public. 

Head First ： But sometimes I see setter methods that simply set the value without check¬ 
ing anything. If you have an instance variable that doesn’t have a boundary, doesn’t that 
setter method create unnecessary overhead? A performance hit? 

Object ： The point to setters (and getters, too) is thatyou can change your mind later ， 
without breaking anybody else’s code! Imagine if half the people in your com¬ 
pany used your class with public instance variables, and one day you suddenly realized, 
“Oops— there’s something I didn’t plan for with that value, I’m going to have to switch to a 
setter method.” You break everyone’s code. The cool thing about encapsulation is \hdlyou 
get to change your mind. And nobody gets hurt. The performance gain from using variables 
directly is so miniscule and would rarely~ if ever — be worth it. 
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how objects behave 


Encapsulating the 
ftoodPog class 


class GoodDog 






>1 






private int size; 

public int getSize() { 

return size; 




- - public void setSize (int s 


size —. s; 


GoodDog 


getSize() 
setSize() 
bark() 


void bark() { 


add ^ WW^ 切，払 “ oo1 ， 
,s you “ 十吁说鱗 d 
bW. featk ad wke a 

—sa-fcv, (asicr, 


Any place where a 
particular value can 
be used, a method 
call that returns that 
type can be used. 

instead of ： 

int x = 3 + 24; 

you can say ： 

int x = 3 + one.getSizeQ; 


if (size > 60) { 

System. out. print In (''Wooof ! Wooof ! 〃）； 
} else if (size > 14) { 

System. out. print In (''Ruff ! Ruff ! 〃）； 

} else { 

System. out. print In (''Yip ! Yip !’’）； 


class GoodDogTestDrive { 

public static void main (String[] args) { 

GoodDog one = new GoodDog(); 
one.setSize(70); 

GoodDog two = new GoodDog(); 
two.setSize(8); 

System, out .println (''Dog one : '' + one . getSize ()); 
System, out .println (''Dog two : '' + two . getSize ()); 
one.bark(); 
two.bark(); 
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How do objects m an array 
behave? 


methods use instance variables 


Just like any other object. The only difference is 
how you get to them. In other words, how you get 
the remote control. Let’s try calling methods on 
Dog objects in an array. 



Declare and create a Dog array, 
to hold 7 Dog references. 


Dog[] 

pets 


pets ; 




Dog array object (Dog[]) 


O 

o 



Create two new Dog objects, 
and assign them to the first 
two array elements. 

pets [0] = new Dog(); 
pets [1] = new Dog(); 


pets[1].setSize(8); 


Call methods on the two Dog 
objects. 


pets[0].setSize(30); 


int x = pets[0].getSize(); 


Dog array object (Dog[]) 


o bje 


-30 \ V 


Dog[] 
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initializing instance variables 


declaring and mitializmg 
instance variables 

You already know that a variable declaration needs at least a name 
and a type: 

int size; 

String name; 

And you know that you can initialize (assign a value) to the 
variable at the same time: 

int size = 420; 

String name = 、 'Donny"; 


But when you don’t initialize an instance variable, what happens 
when you call a getter method? In other words, what is the value of 
an instance variable before you initialize it? 



class PoorDog { 

private int size; 
private String name 

public int getSize() 
return size; 


public String getName() { 

return name; 






* 


Will -tKcsc 代 



Instance variables 
always get a 
default value. If 
you don’t explicitly 
assign a value 
to an instance 
variable，or you 
don’t call a setter 
method, the 
instance variable 
still has a value! 


integers 0 

floating points 0.0 

booleans false 

references null 


public class PoorDogTestDrive { 

public static void main (String[] args) { 
PoorDog one = new PoorDog(); 

System. out. println (''Dog size is ' 
System. out. println (''Dog name is ' 


File Edit Window Help CallVet 


% java PoorDogTestDrive 
Dog size is 0 
Dog name is null 


一如淡’ 

+ one.getSize ()) 

+ one.getName()) 



(Rcmcmbcv, JjK to 六 
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The difference between instance 
and local variables 


methods use instance variables 


pfc Instance variables are declared 
inside a class but not within a method. 

class Horse { 

private double height = 15.2; 
private String breed; 

// more code... 


o Local variables are declared within a method. 

class AddThing { 
int a; 
int b = 12; 

public int add() { 

int total = a + b ; 
return total; 



Local variables MUST be initialized before use! 



class Foo 
public 


int 

int 


void go() { 

X ； 

z = x + 3; 



sr: ㈣ 获 e 

but as sooyv as 70 U try 

io use 

jfveaks 。此 


File Edit Window Help Yikes 


% javac Foo.java 

Foo.java:4: variable x might 
not have been initialized 

int z = x + 3; 

1 error A 


Local variables do 
NOT get a default 
value! The compiler 
complains if you 
try to use a local 
variable before 
the variable is 
initialized. 


^tJiereifirejio 

Dumb Questions 

What about method parameters? 
How do the rules about local variables 
apply to them? 

A- 

Jr \* Method parameters are virtually the 
same as local variables — they’re declared 
/ns/c/e the method (well, technically they’re 
declared in the argument list of the method 
rather than within the body of the method, 
but they’re still local variables as opposed to 
instance variables). But method parameters 
will never be uninitialized, so you’ll never get 
a compiler error telling you that a parameter 
variable might not have been initialized. 

But that’s because the compiler will give 
you an error if you try to invoke a method 
without sending arguments that the method 
needs. So parameters are ALWAYS initialized, 
because the compiler guarantees that 
methods are always called with arguments 
that match the parameters declared for the 
method, and the arguments are assigned 
(automatically) to the parameters. 
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object equality 


Comparing variables (primitives or references) 


Sometimes you want to know if two primitives are the same. That’s easy 
enough, just use the == operator. Sometimes you want to know if two 
reference variables refer to a single object on the heap. Easy as well, just use 
the == operator. But sometimes you want to know if two objects are equal. 

And for that, you need the .equals () method. The idea of equality for 
objects depends on the type of object. For example, if two different String 
objects have the same characters (say, “expeditious”），they are meaningfully 
equivalent, regardless of whether they are two distinct objects on the heap. 
But what about a Dog? Do you want to treat two Dogs as being equal if they 
happen to have the same size and weight? Probably not. So whether two 
different objects should be treated as equal depends on what makes sense for 
that particular object type. We’ll explore the notion of object equality again 
in later chapters (and appendix B), but for now, we need to understand that 
the == operator is used only to compare the bits in two variables. What those 
bits represent doesn’t matter. The bits are either the same, or they’re not. 

To compare two primitives, use the == operator 


Use == to compare 
two primitives, 
or to see if two 
references refer to 
the same object. 

Use the equals() 
method to see 
if two different 
objects are equal. 

(Such as two different 
String objects that both 
represent the characters 

in “Fred”) 


The == operator can be used to compare two variables of any kind, and it 
simply compares the bits. 

if (a == b) {•••} looks at the bits in a and b and returns true if the bit pattern 
is the same (although it doesn’t care about the size of the variable, so all the 
extra zeroes on the left end don’t matter). 

int a = 3; 

byte b = 3; 

if (a == b) { // true } 


仏 c bi 七扣“ 




To see if two references are the same (which means they 
refer to the same object on the heap) use the == operator 


Remember, the == operator cares only about the pattern of bits in the 
variable. The rules are the same whether the variable is a reference or 
primitive. So the == operator returns true if two reference variables refer to 
the same object! In that case, we don’t know what the bit pattern is (because 
it’s dependent on the JVM, and hidden from us) but we do know that whatever 
it looks like, it will be the same for two references to a single object. 


Foo a = 

=new 

Foo () 

• 

f 

Foo b = 

=new 

Foo () 

參 

r 

Foo c = 

=a; 




if (a = 

==b) 

{ 

// 

false } 

if (a : 

==c) 

{ 

// 

true } 

if (b = 

==c) 

{ 

// 

false } 


a 


a 


t is *t\ruc 
b is -false 
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Java > s 


Make ^ 



於油 0 


j j 


are red, 

is chopPA 


Roses 

this po em 

passing by 


is 


passing by 赠 • 


can do better 


7Try»t.R e P' ace ° Ur 

Better yet, 



harpen your pencil 


藏 s ? 二 。一 


and V oU 


What’s legal? 

Given the method below, which 
of the method calls listed on the 
right are legal? 

Put a checkmark next to the 
ones that are legal. (Some 
statements are there to assign 
values used in the method calls). 


KEEP 

4 ™ 

RIGHT 


int calcArea(int height, int width) { 
return height * width; 


int a = calcArea(7, 12); 

short c=7; 

calcArea(c,15); 

int d = calcArea(57); 

calcArea(2,3); 

long t = 42; 

int f = calcArea(t,17); 

int g = calcArea(); 

calcArea(); 

byte h = calcArea(4,20); 
int j = calcArea(2,3,5); 
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exercise: Be the Compiler 



BE 如 compiler 



Each of lire Java files on lliis pa^e 
represents a complete source file. 
Your job is to play compiler and 
determine whetirer each of these files 
will compile. If {key won't 
compile, how would you 
fix Ikem, and if tiiey do 
compile, what would he 
{keiv output? 


A 



class XCopy { 

public static void main(String [] args) { 
int orig = 42; 

XCopy x = new XCopy(); 
int y = x. go(orig); 

System.out.println(orig + 11 11 + y); 

} 

int go(int arg) { 
arg = arg * 2; 


class Clock { 

String time; 

void setTime(String t) { 
time = t; 

} 

void getTime() { 
return time; 


class ClockTestDrive { 

public static void main(String 


return arg; 


Clock c = new Clock(); 

c.setTime("1245 〃）； 

String tod = c.getTime(); 
System.out.println("time: 


[]args) { 


tod); 
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A bunch of Java components, in full costume, are playing a party 
game,"Who ami?” They give you a clue, and you try to guess who 
they are, based on what they say. Assume they always tell the truth 
about themselves. If they happen to say something that could be true 
for more than one guy, then write down all for whom that sentence 
applies. Fill in the blanks next to the sentence with the names of one 
or more attendees. 

Tonight’s attendees: 

instance variable, argument, return, getter, setter, 
encapsulation, public, private, pass by value, method 


A class can have any number of these. 

A method can have only one of these. 

This can be implicitly promoted. 

I prefer my instance variables private. 

It really means ‘make a copy’. 

Only setters should update these. 

A method can have many of these. 

I return something by definition. 

I shouldn’t be used with instance variables. 


I can have many arguments. 

By definition, I take one argument. 
These help create encapsulation. 

I always fly solo. 
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puzzle: Mixed Messages 



Mixed 

Mes^agesi 


A short Java program is listed to your right. 
Two blocks of the program are missing. 
Your challenge is to match the candidate 
blocks of code (below), with the output 

that you'd see if the blocks were inserted. 

Not all the lines of output will be used, and 
some of the lines of output might be used 
more than once. Draw lines connecting 
the candidate blocks of code with their 
matching command-line output. 


Candidates: 

x < 9 
index < 5 

x < 20 
index < 5 

x < 7 
index < 7 

x < 19 
index < 1 


Possible output: 



public class Mix4 { 
int counter = 0; 

public static void main(String [] args) { 

int count = 0; 

Mix4 [] m4a =new Mix4[20]; 
int x = 0; 

while ( ) { 

m4a[x] = new Mix4(); 

m4a[x].counter = m4a[x].counter + 1; 
count = count + 1 ; 

count = count + m4a[x].maybeNew(x); 
x = x + 1; 

} 

System.out .println (count + '、'' 

+ m4a[1].counter); 

} 

public int maybeNew(int index) { 
if ( ) { 

Mix4 m4 = new Mix4(); 

m4.counter = m4.counter + 1; 
return 1; 

} 

return 0; 
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P 祕 1 Puzz]c 



Your job is to take code snippets from the 
pool and place them into the blank lines 
in the code. You may not use the same 
snippet more than once, and you won’t 
need to use all the snippets. Your goal 
is to make a class that will compile and 
run and produce the output listed. 


public class Puzzle4 { 

public static void main(String [] args) { 


int y = 1; 
int x = 0; 
int result = 0; 
while (x < 6) { 


y = y * 10; 


x = 6; 

while (x > 0) { 


Output 


File Edit Window Help BellyFlop 


% java Puzzle4 
result 543345 


Note: Each snippet 
from the pool can be 
used only once! 


result = result + 


System.out,println(result " + result) 


class 


int ivar 


doStuff(int 


if (ivar > 100) { 

return _ 

} else { 

return _ 

} 


ivar = x; 
obs.ivar = x; 
obs[x].ivar = x; 
obs[x].ivar = y; 


doStuff(x); 
obs.doStuff(x); 
obs[x].doStuff(factor); 
obs[x].doStuff(x); 


ivar 
factor 

Puzzle4 [ ] obs = new Puzzle4[6]; public 
Puzzle4b [ ] obs = new Puzzle4b[6]; P r ' vate 
h Puzzle4b [ ] obs = new Puzzle4[6]; 


ivar + factor; 
ivar * (2 + factor); 
ivar * (5 - factor); 
ivar * factor; 


Puzzle4 
Puzzle4b 
Puzzle4b() 


x + 1; 
x -1; 


obs [x] = new Puzzle4b(x); 
obs [ ] = new Puzzle4b(); 
obs [x] = new Puzzle4b(); 
obs = new Puzzle4b( )• 
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puzzle: Five Minute Mystery 



Fast Times in Stim-City 

When Buchanan jammed his twitch-gun into Jai’s side, Jai froze. Jai knew that Buchanan 
was as stupid as he was ugly and he didn’t want to spook the big guy. Buchanan ordered Jai 
into his boss’s office, but Jai’d done nothing wrong, (lately), so he figured a little chat with 
Buchanan’s boss Leveler couldn’t be too bad. He’d been moving lots of neural-stimmers in 
the west side lately and he figured Leveler would be pleased. Black market stimmers weren’t 
the best money pump around, but they were pretty harmless. Most of the stim-junkies he’d 
seen tapped out after a while and got back to life, maybe just a little less focused than before. 


Flye^lnute 


Leveler’s ‘office’ was a skungy looking skimmer, but once Buchanan shoved him in, Jai 
could see that it’d been modified to provide all the extra speed and armor that a local boss like 
Leveler could hope for. “Jai my boy”，hissed Leveler, “pleasure to see you again”. “Likewise 
I’m sure...”，said Jai, sensing the malice behind Leveler’s greeting, “We should be square 
Leveler, have I missed something?” “Ha! You’re making it look pretty good Jai, your volume 
is up, but I’ve been experiencing, shall we say, a little ‘breach’ lately...” said Leveler. 



Jai winced involuntarily, he’d been a top drawer jack-hacker in his day. Anytime someone 
figured out how to break a street-jack’s security, unwanted attention turned toward Jai. “No 
way it’s me man”，said Jai, “not worth the downside. I’m retired from hacking, I just move 
my stuff and mind my own business”. “Yeah, yeah”，laughed Leveler, “I’m sure you’re 
clean on this one, but I’ll be losing big margins until this new jack-hacker is shut 
out!” “Well, best of luck Leveler, maybe you could just drop me here and I’ll go 
move a few more ‘units’ for you before I wrap up today”，said Jai. 


“I’m afraid it’s not that easy Jai, Buchanan here tells me that word is you’re 
current on J37NE”，insinuated Leveler. “Neural Edition? sure I play around a bit, so 
what?”，Jai responded feeling a little queasy. “Neural edition’s how I let the stim-junkies 
know where the next drop will be”，explained Leveler. “Trouble is, some stim-junkie’s stayed 
straight long enough to figure out how to hack into my WareHousing database.” “I need a 
quick thinker like yourself Jai, to take a look at my StimDrop J37NE class; methods, instance 


variables, the whole enchilada, and figure out how they’re getting in. It should..’’ ， “HEY !”， 
exclaimed Buchanan, “I don’t want no scum hacker like Jai nosin’ around my code!” “Easy 
big guy”，Jai saw his chance, “I’m sure you did a top rate job with your access modi.. “Don’t 
tell me - bit twiddler!”，shouted Buchanan, “I left all of those junkie level methods public, 


so they could access the drop site data, but I marked all the critical WareHousing methods 


private. Nobody on the outside can access those methods buddy, nobody!” 


“I think I can spot your leak Leveler, what say we drop Buchanan here off at the comer 
and take a cruise around the block”，suggested Jai. Buchanan reached for his twitch-gun but 
Leveler’s stunner was already on Buchanan’s neck, “Let it go Buchanan”，sneered Leveler, 
“Drop the twitcher and step outside, I think Jai and I have some plans to make”. 
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What did Jai suspect? 

Will he get out of Leveler’s skimmer with all his bones intact? 


methods use instance variables 


Exercise Solutions 


class Clock { 

String time; 

void setTime(String t) { 
time = t; 

} 

String getTime() { 
return time; 


class ClockTestDrive { 

public static void main(String [] args) { 
Clock c = new Clock(); 
c•setTime("1245 〃）； 

String tod = c.getTime(); 

System.out.println( w time: “ + tod); 


A Class ‘XCopy’ compiles and runs as it stands ! The 
output is: ‘42 84’. Remember Java is pass by value, (which 
means pass by copy), the variable ‘orig’ is not changed by the 
go() method. 


Note ： 'Getter methods have a return 
type by definition. 


A class can have any number of these. 

A method can have only one of these. 

This can be implicitly promoted. 

I prefer my instance variables private. 

It really means ‘make a copy’. 

Only setters should update these. 

A method can have many of these. 

I return something by definition. 

I shouldn’t be used with instance variables 
I can have many arguments. 

By definition, I take one argument. 

These help create encapsulation. 

I always fly solo. 


instance variables, getter, setter,method 
return 

return, argument 

encapsulation 

pass by value 

instance variables 

argument 

getter 

public 

method 

setter 

getter, setter, public, private 
return 
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puzzle answers 

Puzzle Solutions 


public class Puzzle4 { 

public static void main(String [] args) { 

Puzzle4b [ ] obs = new Puzzle4b[6]; 

int y = 1; 
int x = 0 ; 
int result = 0; 
while (x < 6 ) { 

obs[x] = new Puzzle4b(); 
obs[x]. ivar = y; 
y = y * 10; 

X = X + 1; 

} 

x = 6; 

while (x > 0) { 

X = X - 1; 

result = result + obs[x].doStuff(x )； 

} 

System.out. println (result " + result); 

} 

} 

class Puzzle4b { 
int ivar; 

public int doStuf f (int factor) { 
if (ivar > 100) { 
return ivar * factor; 

} else { 

return ivar * (5 - factor); 

y Output 


% java Puzzle4 
result 543345 


Answer to the 5-minute mystery... 

Jai knew that Buchanan wasn’t the sharpest 
pencil in the box. When Jai heard Buchanan 
talk about his code, Buchanan never mentioned 
his instance variables. Jai suspected that 
while Buchanan did in fact handle his methods 
correctly, he failed to mark his instance variables 
private. That slip up could have easily cost 
Leveler thousands. 


Candidates: Possible output: 
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5 writing a program 


Extra-Strength Methods 



Let’s put some muscle in our methods. We dabbled with variables, played 

with a few objects, and wrote a little code. But we were weak. We need more tools. Like 
operators. We need more operators so we can do something a little more interesting than, say, 
bark. And loops. We need loops, but what’s with the wimpy while loops? We need for loops 
if we’re really serious. Might be useful to generate random numbers. And turn a String 
into an int, yeah, that would be cool. Better learn that too. And why don’t we learn it all by 
building something real, to see what it’s like to write (and test) a program from scratch. Maybe 
a game, like Battleships.That’s a heavy-lifting task, so it’ll take two chapters to finish. We’ll build 
a simple version in this chapter, and then build a more powerful deluxe version in chapter 6. 
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building a real game 


Let's build a Pattleship-style 
game: "Sink a Pot Com" 

It’s you against the computer, but unlike the real 
Battleship game, in this one you don’t place any ships 
of your own. Instead, your job is to sink the computer’s 
ships in the fewest number of guesses. 

Oh, and we aren’t sinking ships. We’re killing Dot 
Corns. (Thus establishing business relevancy so you can 
expense the cost of this book). 

Goal: Sink all of the computer’s Dot Corns in the fewest 
number of guesses. You’re given a rating or level, based 
on how well you perform. 

Setup: When the game program is launched, the 
computer places three Dot Corns on a virtual 7x7 
grid. When that’s complete, the game asks for your first 
guess. 

How you play: We haven’t learned to build a GUI yet, so 
this version works at the command-line. The computer 
will prompt you to enter a guess (a cell), that you’ll type 
at the command-line as “A3” ， “C5” ， etc.). In response 
to your guess, you’ll see a result at the command¬ 
line, either “Hit” ， “Miss”，or ‘"You sunk Pets.com” (or 
whatever the lucky Dot Com of the day is). When 
you’ve sent all three Dot Corns to that big 404 in the 
sky, the game ends by printing out your rating. 

1)(1 yr\d \s a %以 

A 
B 
C 
D 
E 
F 
G 

0 1 2 3 4 5 6 

、 七 \rts a 七 like Java arrays 
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You’re going to build the 
Sink a Dot Com game, with 
a 7 x 7 grid and three 
Dot Corns. Each Dot Com 
takes up three cells. 


part of a game interaction 


file Edit Window Help Sell 


% java 

DotComBust 

Enter 

a 

guess 

A3 

miss 




Enter 

a 

guess 

B2 

miss 




Enter 

a 

guess 

C4 

miss 




Enter 

a 

guess 

D2 

hit 




Enter 
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guess 

D3 

hit 




Enter 

a 

guess 

D4 

Ouch! 

You sunk 

Pets.com : ( 

kill 
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miss 




Enter 
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G3 

hit 




Enter 
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G4 

hit 




Enter 
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guess 

G5 

Ouch! 

You sunk 

AskMe. com : ( 





























writing a program 


First a high-level design 

We know we’ll need classes and methods, but what 
should they be? To answer that, we need more 
information about what the game should do. 

First, we need to figure out the general flow of the 
game. Here’s the basic idea: 


o User starts the game 

o Game creates three Dot Corns 

Game places the three Dot 
Corns onto a virtual grid 

Game play begins 

Repeat the following until there are 
no more Dot Corns ： 

C H Prompt user for a quess 
^ CA2\ etc.) 

Check the user guess against 7 
all Dot Corns to look for a hit, 
miss, or kill. Take appropri¬ 
ate action ： if a hit, delete cell 
(A2, D4, etc.). If a kill, delete 
Dot Com. 

Game finishes 

Give the user a rating based on 
the number of guesses. 


Now we have an idea of the kinds of things the 
program needs to do. The next step is figuring 
out what kind of objects we’ll need to do the 
work. Remember, think like Brad rather than 
Larry; focus first on the things in the program 
rather than the procedures. 



Whoa. A real flow chart. 
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a simpler version of the game 


The "Simple Pot Com frame" 

a gentler introduction 

It looks like we’re gonna need at least two classes, a 
Game class and a DotCom class. But before we build 
the full monty Sink a Dot Com game, we’ll start with 
a stripped-down, simplified version, Simple Dot Com 
Game. We’ll build the simple version in this chapter, 
followed by the deluxe version that we build in the 
next chapter. 

Everything is simpler in this game. Instead of a 2-D 
grid, we hide the Dot Com in just a single row. And 
instead of three Dot Corns, we use one. 

The goal is the same, though, so the game still needs 
to make a DotCom instance, assign it a location 
somewhere in the row, get user input, and when all 
of the DotCom’s cells have been hit, the game is over. 
This simplified version of the 
game gives us a big head start 
on building the full game. 

If we can get this small one 
working, we can scale it up to 
the more complex one later. 

In this simple version, the 
game class has no instance 
variables, and all the game 
code is in the main() method. 

In other words, when the 
program is launched and 
main() begins to run, it will 
make the one and only DotCom 
instance, pick a location for it (three 
consecutive cells on the single virtual 
seven-cell row), ask the user for a guess, check the 
guess, and repeat until all three cells have been hit. 

Keep in mind that the virtual row is... virtual. In other 
words, it doesn’t exist anywhere in the program. As 
long as both the game and the user know that the 
DotCom is hidden in three consecutive cells out of a 


O &ame starts, and creates ONE DotCom 
and gives it a location on three cells in 
the single row of seven cells. 

Instead of 、、 A2' 、、 C4〃，and so on, the 
locations are just integers (for example ： 
1,2,3 are the cell locations in this 
picture ： 




國_ 





0 1 2 3 4 5 6 


© Game play begins. Prompt user for 
a guess, then check to see if it hit 
any of the DotCom’s three cells. 

If a hit, increment the numOfHits 
variable. 

Game finishes when all three cells have 
been hit (the numOfHits variable val¬ 
ue is 3), and tells the user how many 
guesses it took to sink the DotCom. 

A complete game mteractiow 


% java SimpleDotComGame 

enter a number 2 
hit 

enter a number 3 
hit 

enter a number 4 
miss 

enter a number 1 
kill 

You took 4 guesses 


SimpleDotComGame 

S^mpleDotCom 

int [] locationCells 

void ma j int num0fHjt§ 

String checkYourself(String guess) 
void setLocationCells(int[] loc) 


possible seven (starting at zero), the row itself doesn’t 
have to be represented in code. You might be tempted 
to build an array of seven ints and then assign the 
DotCom to three of the seven elements in the array, 
but you don’t need to. All we need is an array that 
holds just the three cells the DotCom occupies. 
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writing a program 


developing a Class 

As a programmer, you probably have a methodology/ 
process/approach to writing code. Well, so do we. Our 
sequence is designed to help you see (and learn) what 
we’re thinking as we work through coding a class. It 
isn’t necessarily the way we (or you) write code in the 
Real World. In the Real World, of course, you’ll follow 
the approach your personal preferences, project, or 
employer dictate. We, however, can do pretty much 
whatever we want. And when we create a Java class as a 
“learning experience”，we usually do it like this: 

□ Figure out what the class is supposed to do. 

□ List the instance variables and methods. 

□ Write prepcode for the methods. (You’ll see 
this in just a moment.) 


The three things well write for 
each class: 


prep code 


test code 


real code 


This bar is displayed on the next set of pages to tell 
you which part you’re working on. For example, if you 
see this picture at the top of a page, it means you’re 
working on prepcode for the SimpleDotCom class. 

SimpleDotCom class 


prep code ^ >t code 


real code 


prep code 

A form of pseudocode, to help you focus on 
the logic without stressing about syntax. 


□ Write test code for the methods. 

□ Implement the class. 

□ Test the methods. 


test code 

A class or methods that will test the real code 
and validate that it’s doing the right thing. 


□ Debug and reimplement as needed. 

□ Express gratitude that we don't have to test 
our so-called learning experience app on 
actual live users. 


Flex those dendrites. 

How would you decide which class or classes 
to build first, when you’re writing a program? 
Assuming that all but the tiniest programs 
need more than one class (if you’re following 
good 00 principles and not having one class 
do many different jobs), where do you start? 


real code 

The actual implementation of the class. This is 

r a code. 

To Dot 


D 

D 

D 


;im pleDotCom class 

write prep code 
write test code 
writ e final Java code 

S.mpleDotComGame 

class 

□ write prep code 

write test code [nol 
口 wiite code 
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SimpleDotCom class 


prep code — 5t code 


real code 


SimpleDotCom 

int [] locationCells 
int numOfHits 

String checkYourself(String guess) 
void setLocationCells(int[] loc) 


You’ll get the idea of how prepcode (our version of pseudocode) works as you 
read through this example. It’s sort of half-way between real Java code and a plain 
English description of the class. Most prepcode includes three parts: instance 
variable declarations, method declarations, method logic. The most important 
part of prepcode is the method logic, because it defines what has to happen, 
which we later translate into how, when we actually write the method code. 

DECLARE an int array to hold the location cells. Call it locationCells. 

DECLARE an int to hold the number of hits. Call it numOfHits and SET it to 0. 


DECLARE a checkYourself() method that takes a String for the user’s guess ("丨 etc.), 
checks it, and returns a result representing a‘‘hit’’，‘‘miss’’，or‘‘kill’’. 


DECLARE a setLocationCells() setter method that takes an int array (which has the three cell 
locations as ints (2,3,4, etc.). 


METHOD: String checkYourself(String userGuess) 

GET the user guess as a String parameter 
CONVERT the user guess to an int 


- REPEAT with each of the location cells in the int array 

// COMPARE the user guess to the location cell 

- IF the user guess matches 

INCREMENT the number of hits 
// FIND OUT if it was the last location cell: 

- IF number of hits is 3, RETURN "kill" as the result 

ELSE it was not a kill, so RETURN hit 
—— END IF 

ELSE the user guess did not match, so RETURN ‘‘miss’’ 
—— END IF 
—— END REPEAT 
END METHOD 


METHOD: void setLocationCells(int[] cellLocations) 

GET the cell locations as an int array parameter 

ASSIGN the cell locations parameter to the cell locations instance variable 
END METHOD 
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prep code test code 


al code 


Writing the method 
implementations 

lefs write the real 
method code now, and get 
this puppy working. 

Before we start coding the 
methods, though, let’s back 
up and write some code to 
test the methods. That’s right, 
we’re writing the test code 
before there’s anything to test! 

The concept of writing 
the test code first is one of 
the practices of Extreme 
Programming (XP), and 
it can make it easier (and 
faster) for you to write your 
code. We’re not necessarily 
saying you should use XP, 
but we do like the part about 
writing tests first. And XP just 
sounds cool. 


writing a program 



Oh my! For a minute i 
there I thought you 
weren't gonna write your 
test code first. Whoo! 
Don’t scare me like that. 






Extreme Programming (XP) 


Extreme Programming(XP) is a newcomer to the software 
development methodology world. Considered by many 
to be "the way programmers really want to work’;XP 
emerged in the late 90’s and has been adopted by 
companies ranging from the two-person garage shop 
to the Ford Motor Company.The thrust of XP is that the 
customer gets what he wants, when he wants it, even 
when the spec changes late in the game. 

XP is based on a set of proven practices that are all 
designed to work together, although many folks do pick 
and choose, and adopt only a portion of XP’s rules.These 
practices include things like: 

Make small, but frequent, releases. 

Develop in iteration cycles. 


Don’t put in anything that’s not in the spec (no matter 
how tempted you are to put in functionality y/ for the 
future"). 

Write the test code first. 

No killer schedules; work regular hours. 

Refactor (improve the code) whenever and wherever you 
notice the opportunity. 

Don’t release anything until it passes all the tests. 

Set realistic schedules, based around small releases. 

Keep it simple. 

Program in pairs, and move people around so that 
everybody knows pretty much everything about the code. 
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SimpleDotCom class 


prep code test code 


al code 


Writing test code for the SimpleDotCom class 

We need to write test code that can make a SimpleDotCom object 
and run its methods. For the SimpleDotCom class, we really 
care about only the checkYourself() method, although we will have 
to implement the setLocationCells() method in order to get the 
checkYourself() method to run correctly. 

Take a good look at the prepcode below for the checkYourself() 
method (the setLocationCells() method is a no-brainer setter method, 
so we’re not worried about it, but in a ‘real’ application we might 
want a more robust ‘setter’ method, which we would want to test). 

Then ask yourself, “If the checkYourself () method were 
implemented, what test code could I write that would prove to me 
the method is working correctly?” 


Here's what we should test: 

1. Instantiate a SimpleDotCom object. 

2. Assign it a location (an array of 3 ints, like 
{2,3,4}). 

3. Create a String to represent a user guess 
(“2” ， “0” ， etc.). 

4. Invoke the checkYourself() method pass¬ 
ing it the fake user guess. 

5. Print out the result to see if it’s correct 
(“passed” or “failed”). 

IF number of hits is 3, RETURN "Kill" as the result 
ELSE it was not a kill, so RETURN Hit 
END IF 

ELSE the user guess did not match, so RETURN ‘‘Miss’ 1 
END IF 
END REPEAT 
END METHOD 


^ased on this prepcode: 

METHOD String checkYourself(String userGuess) 

GET the user guess as a String parameter 
CONVERT the user guess to an int 
REPEAT with each of the location cells in the int array 
// COMPARE the user guess to the location cell 
IF the user guess matches 

INCREMENT the number of hits 
// FIND OUT if it was the last location cell: 
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al code 


Duni^t^uestiPns 


Maybe I’m missing some¬ 
thing here, but how exactly do 
you run a test on something 
that doesn't yet exist!? 


A ： 


You don’t. We never said 
you start by running the test; 
you start by writing the test. At 
the time you write the test code, 
you won’t have anything to run 
it against, so you probably won't 
be able to compile it until you 
write 'stub' code that can com¬ 
pile, but that will always cause 
the test to fail (like, return null.) 

^/Then I still don't see the 
point. Why not wait until the 
code is written, and then whip 
out the test code? 


A ： 


The act of thinking through 
(and writing) the test code helps 
clarify your thoughts about what 
the method itself needs to do. 

As soon as your implementation 
code is done, you already have 
test code just waiting to validate 
it. Besides, you know\f you don't 
do it now, you’ll never do it. 
There’s always something more 
interesting to do. 

Ideally, write a little test code, 
then write only the implementa¬ 
tion code you need in order to 
pass that test.Then write a little 
more test code and write only 
the new implementation code 
needed to pass that new test. At 
each test iteration,you run all 
the previously-written tests, so 
that you always prove that your 
latest code additions don’t break 
previously-tested code. 


Test code for the SimplePotOom class 


public class SimpleDotComTestDrive { 


public static void main (String[] args) { 


SimpleDotCom dot = new SimpleDotCom(); 










int[] locations = {2,3,4}; 


dot.setLocationCells(locations); 





String 


2 


make a ^akc 

USCV 


，hVokc ihe S C U 


String result = dot.checkYourself(userGuess); 
String testResult = 、、 failed 〃； 


if (result • equals :〃） ) { 




testResult 


'passed 


HL ㈣ 


System.out.println(testResult); 






■f^harpen your pencil 

In the next coup 


couple of pages we implement the SimpleDotCom class, 
and then later we return to the test class. Looking at our test code 
above, what else should be added? What are we nof testing in this 
code, that we should be testing for? Write your ideas (or lines of 
code) below: 
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SimpleDotCom class 


real code 


The chcckYoursclfO method 

There isn’t a perfect mapping from prepcode to javacode; you’ll see a few 
adjustments. The prepcode gave us a much better idea of what the code needs to 
do, and now we have to find the Java code that can do the how. 

In the back of your mind, be thinking about parts of this code you might want 
(or need) to improve. The numbers ① are for things (syntax and language 
features) you haven’t seen yet. They’re explained on the opposite page. 


GET the user 
guess 

CONVERT 

the user guess to 

an int 


REPEAT with 
each cell in the int 
array 

IF the user guess 
matches 


INCREMENT 

the number of 
hits 


public String checkYourself(String stringGuess) { 

① 

int guess = Integer.parselnt(stringGuess); 
String result = ''miss"; ^ - 


-the Siy> 

如 iirt 




3 V ^ blc io hold ihc ^sult w ^|| 


for (int cell : locationCells) 


if (guess = cell) 

result = 、 'hit 〃 

③ 

numOfHits++; 


^ the 

a hii/ 


息卜 “ u 


} // end if 


// FIND OUT if 

it was the last cell 

IF number of hits 
is 3, 

RETURN kill 
as the result 

ELSE it was 
not a kill, so 

RETURN hit 

ELSE 

RETURN 

‘‘miss’’ 


} // end for 


if (numOfHits == locationCells.length) 


result = ''kill- 


} // end if 


代 suit Stvihg to T.l| w ° 


System.out.printin(result); 
return result; 


} // end method 


display -the \rcsul-t -Pov- -the usev 
( w Miss”, unless ii v/as io ov w ^i|| w ) 

^sult b^k io 
the ^allihg method 
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real code 


writing a program 


Just the new stuff 

The things we haven’t seen before 
are on this page. Stop worrying! The 
rest of the details are at the end of 
the chapter. This is just enough to let 
you keep going. 




A wthod m 七 he 
Ihtcjcv- t\ass 七 ha 七 
k^ov/s how *to w pa\rsc W 

d S*brmg m*to 七 he’m 七 7^^ 
i 七 v-cp\rcsc^*b. 


<9 


① 


Converting a 

String to an int 


/ 




Integer.parselnt (“ 3 ”） 


V s 。 仳 


The for loop 


Read tW.s U loo ? deda^on as rcyai 

U ^ C l— 十 ; ㈣ 

Wtake 如 — : 5 V 

a^d Ls»^ *»*t to m-t liable tell • 

for (int cell : locationCells) { } 

-- - 〆 v —-—— 

^ ' . 一 .』 e \。。!. 


i^：[ a 咖，悩 “ if udC 

{{ uin u u ^ S rr SC ah ih ^ va,riablc 

U^Uodad^^ 

m ” ⑽一以 u ihe 

乙 ode do« a bwk ... w # 午 below). 


a^ dV l 






® The post-increment 
operator 


④ 


break statement 


numOfHits++ 


Thc ++ mc3r\s add I io 
v/ha-tevcv^s *thc\rc (m o*thc\r 
v/ords, *m^\rcrwc^*t by I). 


hUmO-fH'i*ts++ is the sStmc (im 
七 his ddse) as saymj ^umO-PHi-b 
^umO-fHi-ts + I, e 乂 dep 七 sli^vtly 

move c-f-Pidic^t 


break; 

^c*ts you ou*t o( a loop. |rr\r»\cdia*tcly- hcv-c- 

Uo i*tcv-a*tioir\, i^o booltd^ *tcs*t, \us 七 （ \e 七 ou-b r\ov/ ! 
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real code 


^fJiereiqrejiP 

Dumb Questions 


^^,-What happens in 
Integer.parselntO if the thing you 
pass isn’t a number? And does it 
recognize spelled-out numbers, 
like "three"? 


A ： 


Integer.parselntO works only 
on Strings that represent the ascii 
values for digits (0,1,2,3,4,5,6,7,8,9). 
If you try to parse something like 
"two”or"blurp’;the code will blow 
up at runtime. (By blow up, we 
actually mean throw an exception, 
but we don’t talk about exceptions 
until the Exceptions chapter. So for 
now, blow up is close enough.) 


In the beginning of the 


book, there was an example of a 
for loop that was really different 
from this one — are there two 
different styles of for loops? 


Yes! From the first version of 
Java there has been a single kind 
of for loop (explained later in this 
chapter) that looks like this: 

for (int i = 0; i < 10; i++) { 

// do something 10 times 

} 

You can use this format for any 
kind of loop you need. But... 
beginning with Java 5.0 (Tiger), 
you can also use the enhanced for 
loop (that's the official description) 
when your loop needs to iterate 
over the elements in an array (or 
another kind of collection, as you’ll 
see in the next chapter). You can 
always use the plain old for loop 
to iterate over an array, but the 
enhanced for loop makes it easier. 


Final code for SimplePotCom and SiwplePotCowTester 

public class SimpleDotComTestDrive { 

public static void main (String[] args) { 

SimpleDotCom dot = new SimpleDotCom(); 
int[] locations = {2,3,4}; 
dot.setLocationCells(locations); 

String userGuess = 、 '2 〃； 

String result = dot.checkYourself(userGuess); 


public class SimpleDotCom { 

int[] locationCells; 
int numOfHits = 0; 

public void setLocationCells (int[] Iocs) { 

locationCells = Iocs; 

} 

public String checkYourself (String stringGuess) { 

int guess 二 工 nteger.parselnt(stringGuess); 
String result = ''miss ”； 
for (int cell : locationCells) { 

if (guess — cell) { 
result = ''hit ”； 
numOfHits++; 
break; 

} 

} // out of the loop 

if (numOfHits == 

locationCells.length) { 
result = ''kill ”； 

} 

System.out.println(result); 
return result; 

} // close method 
} // close class 


There’s a little bug lurking here. It compiles and 
runs, but sometimes... don’t worry about it for now, 
but we will have to face it a little later. 


What should we see 
when we run this code? 

The test code makes a 
SimpleDotCom object 
and gives it a location at 
2,3,4.Then it sends a fake 
user guess of "2” into the 
checkYouselfO method. 

If the code is working 
correctly, we should see the 
result print out: 


java SimpleDotComTestDrive 
hit 
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prep code 


st code 


real code 


writing a program 


— f^harp 

built the ^ 


rpen your pencil 


We built the test class, and the SimpleDotCom class. But we still haven't 
made the actual game. Given the code on the opposite page, and the spec for 
the actual game, write in your ideas for prepcode for the game class. We’ve given 
you a few lines here and there to get you started. The actual game code is on the 
next page, so don’t turn the page until you do this exercise! 


You should have somewhere between 12 and 18 lines (including the ones we wrote, 
but not including lines that have only a curly brace). 


METHOD public static void main (String [] args) 

DECLARE an int variable to hold the number of user guesses, named numOfGuesses 


The SimpleDotComGame 
needs to do this: 

1. Make the single 
SimpleDotCom Object. 

2. Make a location for it (three 
consecutive cells on a single 
row of seven virtual cells). 

3. Ask the user for a guess. 

4. Check the guess. 

5. Repeat until the dot com is 
dead . 


6.Tell the user how many 
guesses it took. 


COMPUTE a random number between 0 and 4 that will be the starting location cell position 


WHILE the dot com is still alive : 

GET user input from the command line 


A complete game iwteractiow 


File Edit Window Help Runaway 


% java SimpleDotComGame 

enter a number 2 
hit 

enter a number 3 
hit 

enter a number 4 
miss 

enter a number 1 
kill 

You took 4 guesses 


you are here ► 
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SimpleDotCom class 


prep code 


st code 


real code 


Prepcode for the SimplePotCom^ame class 

Everything happens w mainO 

There are some things you’ll have to take on faith. For example, we have one 
line of prepcode that says, “GET user input from command-line”. Let me tell 
you, that’s a little more than we want to implement from scratch right now. But 
happily, we’re using OO. And that means you get to ask some other class/object 
to do something for you, without worrying about how it does it. When you write 
prepcode, you should assume that somehow you 5 11 be able to do whatever you 
need to do, so you can put all your brainpower into working out the logic. 


public static void main (String [] args) 

DECLARE an int variable to hold the number of user guesses, named numOfGuesses, set it to 0. 
MAKE a new SimpleDotCom instance 

COMPUTE a random number between 0 and 4 that will be the starting location cell position 

MAKE an int array with 3 ints using the randomly-generated numben that number incremented by I, 
and that number incremented by 2 (example: 3,4,5) 

INVOKE the setLocationCells() method on the SimpleDotCom instance 

DECLARE a boolean variable representing the state of the game, named isAlive. SET it to true 


WHILE the dot com is still alive (isAlive == true) : 

GET user input from the command line 
// CHECK the user guess 

INVOKE the check 丫 ourself() method on the SimpleDotCom instance 
INCREMENT numOfGuesses variable 


// CHECK for dot com death 
IF result is "kill" 


SET isAlive to false (which means we won't enter the loop again) 
PRINT the number of user guesses 


END IF 
END WHILE 
END METHOD 



metacogtiitive tip 


Don’t work one part of the brain for too long a stretch at one time. 
Working just the left side of the brain for more than 30 minutes 
is like working just your left arm for 30 minutes. Give each side 
of your brain a break by switching sides at regular intervals. 

When you shift to one side, the other side gets to rest and 
recover. Left-brain activities include things like step-by-step 
sequences, logical problem-solving, and analysis, while the 
right-brain kicks in for metaphors, creative problem-solving, 
pattern-matching, and visualizing. 
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writing a program 


— BULLET POINTS HP_ 

■ Your Java program should start with a high- 
level design. 

■ Typically you'll write three things when you 
create a new class: 

prepcode 

testcode 

real (Java) code 

■ Prepcode should describe what io do, not how 
to do it. Implementation comes later. 

■ Use the prepcode to help design the test 
code. 

■ Write test code before you implement the 
methods. 


■ Choose for loops over while loops when you 
know how many times you want to repeat the 
loop code. 

■ Use the pre/post increment operator to add 1 
to a variable (x++;) 

■ Use the pre/post decrement to subtract 1 from 
a variable (x-;) 

■ Use Integer. parselnt ( ) to get the int 
value of a String. 

■ Integer. parselnt ( ) works Only if the 
String represents a digit (“0”,T’,”2”, etc.) 

■ Use break to leave a loop early (i.e. even if 
the boolean test condition is still true). 



ptom n 娜外 
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SimpleDotComGame class 


real code 


The game's mam() method 


Just as you did with the SimpleDotCom class, be thinking about parts of this code 
you might want (or need) to improve. The numbered things ① are for stuff we 
want to point out. They’re explained on the opposite page. Oh, if you’re wonder¬ 
ing why we skipped the test code phase for this class, we don’t need a test class for 
the game. It has only one method, so what would you do in your test code? Make 
a separate class that would call main() on this class? We didn’t bother. 


DECLARE a vari¬ 
able to hold user 
guess count, set it 
to 0 


MAKE a SimpleDot¬ 
Com object 

COMPUTE a 

random number 
between 0 and 4 

MAKE an int array 
with the 3 cell loca¬ 
tions, and 

INVOKE setLoca 
tionCells on the dot 
com object 

DECLARE a bool¬ 
ean isAlive 

WHILE the dot 
com is still alive 

GET user input 

// CHECK it 

INVOKE checkYo- 
urself() on dot com 

INCREMENT 

numOfGuesses 

IF result is "kill" 

SET game Alive to 
false 

PRINT the number 
of user guesses 


public static void main(String[] args) { 
int numOfGuesses = 0; ^ 


a va' 




GameHelper helper = new GameHelper(); 


七 his is d dlass y/c y/\ro*tc "that hds 

"the rwctliod -fov usev mput -Pov 

y\oyN, pvcichd its part o( Java 


SimpleDotCom theDotCom = new SimpleDotCom () ; ^ - 、 七 ^ 

int randomNum = (int) (Math .Random() * 5); 卜 a v-ahdom humbev- -fov -tKc 

u\l a^d use i-t -to make -the ^11 
- lo^a-tiohs avvay 

int[] locations = {randomNum , randomNum+1 , randomNum+2}; 


theDotCom.setLocationCells(locations); 


boolean isAlive = true 




_ ^ M 咖 如 IcaWs a„a 7 ) 


nr»ake a boolean variable -to -tv-adk y/lic-thcv- -the 
is s*ti|| alive, 七 。 use m "the v/hilc loop test vcpcat 
while is still alive- 

@ w— 

String guess = helper. getUserInput (''enter a number") 


while(isAlive == true) 


String result = theDotCom. checkYourself (guess) ; ^sk 4-U e j i . 

^*^1. ° ot io 

the guess ； sa /, ] CCK 

numOfGuesses++; ^ —— gu C ss ^ ^ hcd 

if (result .equals (''kill^)) ., Wl n 

^ r * V 1 r sct isAr,vc ^ ^ - -1 

isAlive = false ; 4 e eivteir the loop ； and pirihi usev guess dou^j-^ 


System. out. println (''You took 

} // close if 


} // close while 


numOfGuesses + '' guesses") 


} // close main 
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real code 


writing a program 


randomO and getUserlnputO 

Two things that need a bit more 
explaining, are on this page. This is 
just a quick look to keep you going; 
more details on the GameHelper 
class are at the end of this chapter. 


① 


Make a random 
number 


This is a W’, 3 hd it lu. 1 L- 

P a^ o( the double.^ 


丁 V^c Ma*t^.vay>dow wc*b^od 

a z^vo to 

； us-t less o,e. So -bW»s 
L 七 V^c ^),vcW a^bev- 

W 。七。今 .（ lc . 0 - 十 ”” ..， 
⑽ 七七 o a 饩七） 


int randomNum = (int) (Math.randomQ * 5) 




Wt deda\re a 的 m 七 vaviablc *to hold 
\ra^dom y/e bd£>k- 


r 


/N 


A ^l^ ss 七 domes A rwethod o( 
y/i*th Java- /l/Jaih c\ass. 


© Setting user input 
using the GameHelper 
class 


/ \r> \Y\siav\U v/c made cavlic^, 

Jc a c\ass i\\ai built io 
Kelp W\{}\ ^a^c- l*t s called 

^amcttclpcv* dnd you Kavc^ *t 
scer^ i*t yc*t (you y/iII). 


This 





String guess 


helper.getUserInput(“enter a number ”）； 




a 


u^k la,rc a s 仏 r 3 vahablc ^ 

^ 


A mc*thod o-f *thc ^arwcttclpcv dass 

七 dsks *thc USCV- *f OV" 乙 ow\m 扣 (1 一 

Ime mpu*t, \redds i*t m a-f*tcv- 
usc\r hits RETURN, a^d jives ba^k 
the \rcsul 七 as a S*t\r*mg. 
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GameHelper class (Ready-bake) 



One last class: GameHelper 

We made the dot com class. 

We made the game class. 

All that’s left is the helper class — the one with the 
getUserInput() method. The code to get command¬ 
line input is more than we want to explain right now. 
It opens up way too many topics best left for later. 
(Later, as in chapter 14.) 


Just copy* the code below and compile it into 
a class named GameHelper. Drop all three 
classes (SimpleDotCom, SimpleDotComGame, 
GameHelper) into the same directory, and make it 
your working directory. 



Whenever you see the logo, youVe see¬ 

ing code that you have to type as-is and take on faith. 
Trust it. You’ll learn how that code works later. 


Cade 


import java.io.*; 
public class GameHelper { 

public String getUserInput(String prompt) { 
String inputLine = null; 

System, out .print (prompt + '' ''); 

try { 

BufferedReader is = new BufferedReader( 
new InputStreamReader(System.in)); 
inputLine = is.readLine(); 

if (inputLine.length() == 0 ) return null 
} catch (IOException e) { 

System. out. pr in tin ('' IOExcep tion : '' + e); 


return inputLine; 
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*We know how much you enjoy typing, but for those rare 
moments when you’d rather do something else, we’ve made 
the Ready-bake Code available on wickedlysmart.com. 














writing a program 


Let's play 

Here's what happens when we 
run it and enter the numbers 
1,2,3,4,5,6. LookiiV good. 

A complete game mteractiow 

(your mileage may vary) 


% java SimpleDotComGame 
enter a number 1 
miss 

enter a number 2 
miss 

enter a number 3 
miss 

enter a number 4 
hit 

enter a number 5 
hit 

enter a number 6 
kill 

You took 6 guesses 


Whafs this? A bug? 

Gasp! 

Here's what happens when we 
enter 1,1,1. 

A differewt game interaction 

(yikes) 


% java SimpleDotComGame 
enter a number 1 
hit 

enter a number 1 
hit 

enter a number 1 
kill 

You took 3 guesses 



<r 考 rpen your pencil 


It’s a cliff-hanger! 

Will we find the bug? 

Will we fix the bug? 


he next chapter, where we answer 
ns and more... 


And in the meantime, see if you can come up with 
ideas for what went wrong and how to fix it. 
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for loops 


More about for loops 

We’ve covered all the game code for this chapter (but we’ll pick it up again 
to finish the deluxe version of the game in the next chapter). We didn’t 
want to interrupt your work with some of the details and background info, 
so we put it back here. We’ll start with the details of for loops, and if you’re 
a C++ programmer, you can just skim these last few pages... 


Regular (Hon-enhanced) for loops 


ihc 


c °dc i 0 


， os 七- m 〜 ⑽外 七 




for(int i 


l 


ihitiali 




0; i < 100; i++) { } 

T , 

boolean icsi \i c}r ai\oY\ e^ess\om 


What it means in plain English: "Repeat 100 times." 
How the compiler sees it: 

t create a variable / and set it to 0. 
t repeat while / is less than 100. 
t at the end of each loop iteration, add 1 to / 


Part One: initialization 

Use this part to declare and initialize a variable to use within the loop body. 
You’ll most often use this variable as a counter. You can actually initialize more 
than one variable here, but we’ll get to that later in the book. 

Part Two: boolean test 

This is where the conditional test goes. Whatever’s in there, it must resolve to a 
boolean value (you know, true or false). You can have a test, like (x >= 4), or you 
can even invoke a method that returns a boolean. 

Part Three: iteration expression 

In this part, put one or more things you want to happen with each trip through 
the loop. Keep in mind that this stuff happens at the end of each loop. 


repeat for 100 reps 
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Trips through a loop 、多 

for (int i = 0; i < 8; i++) { 

System.out.printin(i); 

} 

System, out. prin tin (''done"); 



difference between for and while 



A while loop has only the boolean test; it doesn’t have 
a built-in initialization or iteration expression. A while 
loop is good when you don’t know how many times to 
loop and just want to keep going while some condi¬ 
tion is true. But if you know how many times to loop 
(e.g. the length of an array, 7 times, etc.), a for loop is 
cleaner. Here’s the loop above rewritten using while: 


int i 
while 


= 0 ; ^ — 
(i < 8) { 




System.out.printin(i); 


i++; 


^ hdv c io 


ihc 




C\r 




System, out .printin (''done A, ); 


output: 

File Edit Window Help Repeat 


% java Test 

0 

1 

2 

3 

4 

5 

6 
7 

done 


+ + 




Pre and Post Increment/Decrement Operator 


The shortcut for adding or subtracting 1 from a variable. 

X ++； 

is the same as: 

X = X + 1 ； 

They both mean the same thing in this context: 

"add 1 to the current value of x”or "increment x by 1 w 
And: 

X ——； 

is the same as: 

X = X - 1 ； 

Of course that’s never the whole story.The placement of the 
operator (either before or after the variable) can affect the re¬ 
sult. Putting the operator before the variable (for example, ++x), 
means/'first, increment x by 1,and then use this new value of x .〃 
This only matters when the ++x is part of some larger expres¬ 
sion rather than just in a single statement. 

int x = 0; int z = ++x; 

produces: x is 1,z is 1 

But putting the ++ after the x give you a different result: 

int x = 0; int z = x++; 

produces: x is 1, but z is 0! z gets the value of x and then x is 
incremented. 


you are here ► 115 















enhanced for 


The gwhawcgd for loop 

Beginning with Java 5.0 (Tiger), the Java language has a second kind of for loop 
called the enhanced for, that makes it easier to iterate over all the elements in an 
array or other kinds of collections (you’ll learn about other collections in the next 
chapter). That’s really all that the enhanced for gives you — a simpler way to walk 
through all the elements in the collection, but since it’s the most common use of a 
/or loop, it was worth adding it to the language. We’ll revisit the enhanced for loop in 
the next chapter, when we talk about collections that aren Y arrays. 


Pedlar aw iteration vanablc The (!o/o h (：) 
Will Kold a sm^lc clc 州⑼七 (W" 

•m 七 ay* 


1 


Thc 幻 dc 匕 

歡4?卜 


for (String name : nameArray) { } 


T .. 〆 丄 ， 祕 

l ihc a d 似⑽七 七 

針吖.職 T b c …如 a 叫一 


Compatible with ihc 


dcda ^ d vaK,ab| « ^. 


td -to 


TKe toWubo, o( tode said ： 

一 A ， 二 ( w ， M 7 紗 
u c vtevaW ， 如 v r\ ^ w Mav-y, 


What it means in plain English: "For each element in nameArray, assign the 
element to the'name 7 variable, and run the body of the loop." 


How the compiler sees it: 

t Create a String variable called name and set it to null, 
t Assign the first value in nameArray to name. 

t Run the body of the loop (the code block bounded by curly braces), 
t Assign the next value in nameArray to name, 
t Repeat while there are still elements in the array. 

Part One: iteration variable declaration 

Use this part to declare and initialize a variable to use within the loop body. With each 
iteration of the loop, this variable will hold a different element from the collection.The 
type of this variable must be compatible with the elements in the array! For example, 
you can't declare an int iteration variable to use with a String 口 array. 

Part Two: the actual collection 

This must be a reference to an array or other collection. Again, don't worry about the 
other non-array kinds of collections yet — you’ll see them in the next chapter. 


Note: dcpchdmg oh the 

吹 d the ? asi, people 

if -Pov as 

the ^ ov^ the u -Pov- 

⑹仏 how it 


^rC3ds 

亡 oils 匕 tioh … 
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Converting a String to an int 

int guess = Integer.parselnt(stringGuess); 

The user types his guess at the command¬ 
line, when the game prompts him.That 
guess comes in as a String ("2’;"0’;etc.), 
and the game passes that String into the 
checkYourself() method. 

But the cell locations are simply ints in an 
array, and you can’t compare an int to a 
String. 

For example, this won't work: 

String num ="2 〃； 
int x = 2; 

if (x == num) // horrible explosion! 

Trying to compile that makes the compiler 
laugh and mock you: 


operator == cannot be applied to 
int,java.lang.String 

if (x == num) { } 


So to get around the whole apples and 
oranges thing, we have to make the String 
"2 〃 into the int 2. Built into the Java class 
library is a class called Integer (that’s right, 
an Integer class, not the int primitive), 
and one of its jobs is to take Strings that 
represent numbers and convert them into 
actual numbers. 





"t^kcs s S 七 \ri 


… 3 


Integer.parselnt (“ 3 ”） 



a method *m -the /htegev- 
fldss khows how "to 
a iivt 。 

•…七 i 七 \rcp\rcsch-b. 



Castma 

pri 



long 


- ^ short 

can be cast to 



but you might 
lose something 



In chapter 3 we talked about the sizes of the various primitives, and how you 
can’t shove a big thing directly into a small thing: 

long y = 42; 

int x = y; // won't compile 

A long is bigger than an int and the compiler can’t be sure where that long has 
been. It might have been out drinking with the other longs, and taking on really 
big values. To force the compiler to jam the value of a bigger primitive variable 
into a smaller one, you can use the cast operator. It looks like this: 


long y = 42; // so far so good 

int x = (int) y; // x = 42 cool! 


Putting in the Ccist tells the compiler to take the value of y, chop it down to int 
size, and set x equal to whatever is left. If the value of y was bigger than the 
maximum value of x, then what’s left will be a weird (but calculable*) number: 


long y = 40002; 

// 40002 exceeds the 16-bit limit of a short 


short x = (short) y; // x now equals -25534! 

Still, the point is that the compiler lets you do it. And let’s say you have a float¬ 
ing point number, and you just want to get at the whole number (int) part of it: 


float f = 3.14f ; 

int x = (int) f; // x will equal 3 

And don’t even think about casting anything to a boolean or vice versa—just 
walk away. 

*lt involves sign bits, binary, Iwo^ complement’ and other geekery, all of which 
are discussed at the beginning of appendix B. 
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exercise: Be the JVM 



ExieRciSie 


BEtk JViVl 



The Java file on tiiis pa^e 
represents a complete source 
file. Your job is to play JVM 
and determine what would be 

tire output when tire 
program runs? 


class Output { 


File Edit Window Help OM 


% java Output 
12 14 


public static void main(String [] args) { 
Output o = new Output(); 
o•go(); 


-or- 


void go() { 
int y = 7; 
for(int x = 1; 

y++; 

if (x > 4) { 


x < 8; x++) { 


System.out.print(++y + 


File Edit Window Help Incense 


% java Output 
12 14 x = 6 


-or- 


if (y > 14) { 

System.out.println(" x 


x) 


break 


File Edit Window Help Believe 


% java Output 
13 15 x = 6 
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S3 


Code Magnets 

A working Java program is all scrambled up on the fridge. Can you 
reconstruct the code snippets to make a working Java program that 
produces the output listed below? Some of the curly braces fell on the 
floor and they were too small to pick up, so feel free to add as many of 
those as you need! 







PUbii c stati 


c void 
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puzzle: JavaCross 



1 


2 









3 






4 

5 





6 















7 





8 


9 


10 








11 




12 























13 









14 




15 




16 


















17 








18 




19 






















20 


21 
























22 










23 



24 










25 







26 




27 
















28 











29 













JavaO 祕 


How does a crossword puzzle 
help you learn Java? Well, all 
of the words are Java related. 
In addition, the clues provide 
metaphors, puns,and the like. 
These mental twists and turns 
burn alternate routes to Java 
knowledge, right into your 
brain! 


Across 

I. Fancy computer word 
for build 

4. Multi-part loop 

6. Test first 

7. 32 bits 

10. Method's answer 

II. Prepcode-esque 
13. Change 

15. The big toolkit 

17. An array unit 

18. Instance or local 


20. Automatic toolkit 

22. Looks like a primitive, 
but.. 

25. Un-castable 

26. Math method 

28. Converter method 

29. Leave early 


Down 

2. Increment type 

3. Class's workhorse 

5. Pre is a type of_ 

6. For’s iteration_ 

7. Establish first value 

8. While or For 

9. Update an instance variable 
12. Towards blastoff 

14. A cycle 

16. Talkative package 

19. Method messenger 
(abbrev.) 


21. As if 

23. Add after 

24. Pi house 

26. Compile it and 

27. ++ quantity 
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writing a program 



Mes^agesi 


A short Java program is listed below. One block of the program 
is missing. Your challenge is to match the candidate block of 
code (on the left), with the output that you’d see if the block 
were inserted. Not all the lines of output will be used, and some 
lines of output might be used more than once. Draw lines 
: ing the candidate blocks of code with their matching 
command-line output. 


of the lir 
connecti 


class MixFor5 { 

public static void main(String [] args) { 

int x = ◦; 


int y = 30; 

for (int outer = 0; outer < 3; outer++) 
for (int inner = 4; inner > 1; inner--) 



y = y - 2; 
if (x == 6) 
break; 

} 

x = x + 3 ; 


} 

y 


y 


2 ; 


卜 


System.out.println(x 


\\ 


y) 


Candidates: 



Possible output: 



? ossA)\c 。咖小 
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exercise solutions 



Solutions 


Be the JVM ： 


class Output { 


public static void main(String [] args) { 
Output o = new Output(); 
o•go(); 


void go() { 
int y = 7; 

for(int x = 1; x < 8; x++) { 

y++; 

if (x > 4) { 

System.out.print(++y + 


if (y > 14) { 

System, out. println (x 


+ x); 


break 


Did you remember to factor in the 
break statement? How did that 
affect the output? 


File Edit Window Help MotorcycleMaintenance 


% java Output 
13 15 x = 6 


Code Magnets ： 

class MultiFor { 


public static void main(String [] args) { 


for(int x = 0; x < 4; x++) { 


for(int y = 4; y > 2; y--) 
System.out.println(x + " 

} 


Y) 


if (x == 1) { 
x++; 

} 


What would happen 
if this code block came 
before the y* for loop? 
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writing a program 



puzzle Solutions 



Candidates: 


Possible output: 
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6 get to know the Java API 


Using the Java Library 



Java ships with hundreds of pre-built classes. You don’t have to 

reinvent the wheel if you know how to find what you need in the Java library, known as 
the Java API. You've got better things to do. If you’re going to write code, you might as well 
write only the parts that are truly custom for your application. You know those programmers 
who walk out the door each night at 5 PM? The ones who don’t even show up until 10 AM? 
They use the Java API. And about eight pages from now, so will you.The core Java library 
is a giant pile of classes just waiting for you to use like building blocks, to assemble your own 
program out of largely pre-built code.The Ready-bake Java we use in this book is code you 
don’t have to create from scratch, but you still have to type it.The Java API is full of code you 
don’t even have to type. AW you need to do is learn to use it. 
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we still have a bug 

Iw our last chapter, we left you 
with the cliff hawger. A bug. 


How ifs supposed to look 

Here's what happens when we 
run it and enter the numbers 
1,2,3,4,5,6. LookiiV good. 

A complete game mteractiow 

(your mileage may vary) 


% java SimpleDotComGame 
enter a number 1 
miss 

enter a number 2 
miss 

enter a number 3 
miss 

enter a number 4 
hit 

enter a number 5 
hit 

enter a number 6 
kill 

You took 6 guesses 


How the bug looks 

Here's what happens when we 
enter 2,2,2. 

A different game mteractiow 

(yikes) 


% java SimpleDotComGame 
enter a number 2 
hit 

enter a number 2 
hit 

enter a number 2 
kill 

You took 3 guesses 


Iki the current version, once 
you get a hit you can simply 
repeat that hit two wore 
times for the kill! 
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So what happened? 


get to know the Java API 


public String checkYourself(String stringGuess) { 



Integer.parselnt(stringGuess); ^ - - 


Co^i ihc Si^a 

to dh ih*t. 


String result 


''miss" 


^ ^iss | h 
[i c * wc a 


for (int cell : locationCells) { 


Here’s where it 
goes wrong. We 
counted a hit every 一 ^ 
time the user 
guessed a cell 
location, even if 


if (guess = 

=cell) { 

result = 



wc ^oi a W\il 

numOfHits ++; 善 


Corhpairc the use^ 

9^ss io -this c l c ^ Ch i 

^cll), i h -the av-v-ay. 




that location had 
already been hit! 


— ㈣ ::r- 


} // end if 


We need a way to 
know that when 
a user makes 
a hit, he hasn’t 
previously hit that 
cell. If he has, then 
we don’t want to 
count it as a hit. 


} // end for 

if (numOfHits == locationCells. length) { » 

^ ^ out o( the loop, but 

result = ''kill"; Ws see i-p wcVc how 'dead' 

hit 孓 "times) -the 

} // end if t 。 “kill” 

System.out.println(result) ; Display the v-esuli (or i\\c user 

Ciss", unless i-t v/3s dhdhaed *to u hi*b W o\r w kil| W ). 
return result; J 

the result b^k io 

II end method 仏 e dallihg method. 
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fixing the bug 

How do we fix it? 


We need a way to know whether a cell has already been hit. Lefs run 
through some possibilities, but first, we’ll look at what we know so far... 

We have a virtual row of 7 cells, and a DotCom will occupy three 
consecutive cells somewhere in that row. This virtual row shows a 
DotCom placed at cell locations 4,5 and 6. 



o 


2 


3 


4 


5 


6 


越驗 V he 


The DotCom has an instance variable—an int array—that holds that 
DotCom object’s cell locations. 


locationCells 

(instance variable of 
the DotCom) 


4 5 6 

bbti 


0 


2 


— b，e 


〆 lit 

1? ^ 6 - Those all ±1 valuc f ^ 
ihc ^ hccds io ^ ‘ 


① Option one 

We could make a second array, and each time the user makes a hit, we 
store that hit in the second array, and then check that array each time 
we get a hit, to see if that cell has been hit before. 



false false true 





hitCells array 

(this would be a 
new boolean array 
instance variable of 
the DotCom) 


hht ^ 


0 


1 


2 
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Option one is too clunky 

Option one seems like more work than you’d expect. It means that each 
time the user makes a hit, you have to change the state of the second 
array (the 'hitCells* array), oh — but first you have to CHECK the 'hitCells* 
array to see if that cell has already been hit anyway. It would work, but 
there's got to be something better... 


@ Option two 

We could just keep the one original array, but change the value of any hit 
cells to -1. That way, we only have ONE array to check and manipulate 


locationCells 

(instance variable of 
the DotCom) 


4 5 

bbh 




o 


2 


Option two is a little better, but 
still pretty clunky 

Option two is a little less clunky than option one, but it’s not very efficient. You’d 
still have to loop through all three slots (index positions) in the array, even if 
one or more are already invalid because they ve been 'hif (and have a -1 value). 
There has to be something better... 
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prep code 



real code 


③ Option three 

We delete each cell location as it gets hit, and then modify the array to 
be smaller. Except arrays caiVt change their size, so we have to make a 
new array and copy the remaining cells from the old array into the new 


smaller array. 


locationCells array 

BEFORE any cells 
have been hit 


4 5 6 


o 


2 


/ D -i. ^ wc * 00 P *thlrouah a \] I . n 

( posi-tiohs )h a^yj) L I l C 

“如 + L y 七 look ‘ 

忪絀 v ,| u ；?^ V C " 9UCSS " hd 


locationCells array 

AFTER cell '5*, which 
was at index 1 in the 
array, has been hit 


4 6 


0 


°^ al lo^iio^lls ihe 


Option three would be much better if the array could shrink, so that we wouldn't have 
to make a new smaller array, copy the remaining values and reassign the reference. 


The original prepcode for part of the Life would be good if only we could 

checkYourselfO method: change itto: 


REPEAT with each of the location cells in the int array _ 
// COMPARE the user guess to the location cell 
IF the user guess matches 

INCREMENT the number of hits 
// FIND OUT if it was the last location cell: 

IF number of hits is 3, RETURN "kill” 

ELSE it was not a kill, so RETURN hit 
END IF 

ELSE user guess did not match, so RETURN "miss” 
END IF 
END REPEAT 


^ REPEAT with each of the remaining location cells 
// COMPARE the user guess to the location cell 
IF the user guess matches 
^ REMOVE this cell from the array 

// FIND OUT if it was the last location cell: 

_ IF the array is now empty, RETURN "kill" 
ELSE it was not a kill, so RETURN hit 
END IF 

ELSE user guess did not match, so RETURN "miss 
END IF 
END REPEAT 
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If only I could find an array 
that could shrink when you remove 
something. And one that you didnt have 
to loop through to check each element, but 
instead you could just ask it if it contains 
what you're looking for. And it would let you 
get things out of it, without having to know 
exactly which slot the things are in. 

That would be dreamy. But I know ifs 
just a fantasy... 
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when arrays aren’t enough 


Wake up and smell the library 


As if by magic, there really is such a thing. 

But it’s not an array, it’s an ArrayLisL 
A class in the core Java library (the API). 

The Java Standard Edition (which is what you have unless you’re work¬ 
ing on the Micro Edition for small devices and believe me, you’d know) 
ships with hundreds of pre-built classes. Just like our Ready-Bake code 
except that these built-in classes are already compiled. 


That means no typ 二 
Just use 'em. 


/VrrayList 


Or\t of B gdzjllio 灼 dlasses m 

七 he Java libvav-y. 

〜 •.一 ：丄 … coAt 


you da 灼 use 
as i-f you w\ro' 


(Note ： tKc addi(Objcd*t clcm) mc-tKod 
adtually looks a little 
one y/c’vc sliown licvc... y/cll gc 七七 o 七 lie 
veal or\t la*tcv \y\ book. Fov now, just 
*t^mk o( i*t as an addiO method 七 ha 七 
takes 七 he objed 七 you warrt 七。 add ) 
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Some things you caw do with Arraylist 

① Make one y^Wt ⑽札》七 j us *t w 灼 ，參 

ArrayList<Egg> myList = new ArrayList<Egg> () ,' 

一 n , . 心 ㈣ 切 . 

( 2 ) Put something in it 


Egg s = new Egg (); 


myList. add (s); 


(3) Put another thing in it 

Egg b = new Egg() 

myList. add (b); 


treated 

V)C63vaSC 



Kon, -tv.c A^a 7 Ust yro^s a w bo^ 
io V^oia ^ ob j cdt - 



\ Ue ^^Egg objcTi^ 1 " io hold 


④ Find out how many things are in it 

int theSize = myList. size(); 





so 


⑤ Find out if it contains something n e & 工 f 

boolean isln = myList. contains (s) ; ^ rt\cctt\tta 07 ’ 


. 1 ^ ^ j 七 u^dc* *s 0) 

⑥ Find out where something is (i.e. its index) y Aw-aYUsi »s 二 ^ y ^ as 

int idx = myList. indexOf (b); 


〆 上 : r 


(7) Find out if ifs empty 

boolean empty = myList. isEmpty () ; t . — 




⑧ Remove something from it 

myList. remove (s); 



ttcy look — i*t sKv-ar\k! 
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i^^rpen your pencil 


Fill in the rest of the table below by looking at the ArrayList code 
on the left and putting in what you think the code might be if it 
were using a regular array instead. We don’t expect you to get all 
of them exactly right, so just make your best guess. 


ArrayList regular array 


ArrayList<String> myList = new 
ArrayList<String>(); 

C3 myLis 七二 y\C^i 



String a = new String (''whoohoo ”）； 

Stvmj d ― S*tv , ir\^ u y/hoohoo , 0 ； 

myList.add(a); 




String b = new String (''Frog"); 


myList.add(b); 




int theSize = myList.size (); 




Object o = myList.get(1); 




myList.remove(1); 




boolean isln = myList.contains (b); 
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Dumb Questions 

^^,-So ArrayList is cool, but 
how would I know it exists? 



Java Bxyosedi 

This week’s interview: 
ArrayList, on arrays 


^\^lThe question is really, 

"How do I know what’s in the 
API?" and that's the key to your 
success as a Java programmer. 
Not to mention your key to 
being as lazy as possible while 
still managing to build software. 
You might be amazed at how 
much time you can save when 
somebody else has already done 
most of the heavy lifting, and 
all you have to do is step in and 
create the fun part. 

But we digress... the short 
answer is that you spend some 
time learning what’s in the core 
API. The long answer is at the 
end of this chapter, where you’ll 
learn howto do that. 

But that’s a pretty big 
issue. Not only do I need to 
know that the Java library 
comes with ArrayList, but more 
importantly I have to know 
that ArrayList is the thing that 
can do what I want! So how 
do I go from a need-to-do- 
something to a-way-to-do-it 
using the API? 

A- 

Now you’re really at the 
heart of it. By the time you’ve 
finished this book,you’ll have 
a good grasp of the language, 
and the rest of your learning 
curve really is about knowing 
how to get from a problem to 
a solution, with you writing the 
least amount of code. If you can 
be patient for a few more pages, 
we start talking about it at the 
end of this chapter. 


Head First: So, Array Lists are like arrays, right? 

ArrayList ： In their dreams! / am an object thank you very much. 

HeadFirst: If I’m not mistaken, arrays are objects too. They live on the heap right 
there with all the other objects. 

ArrayList ： Sure arrays go on the heap, duh, but an array is still a wanna-be 
ArrayList. A poser. Objects have state and behavior, right? We’re clear on that. But 
have you actually tried calling a method on an array? 

HeadFirst ： Now that you mention it, can’t say I have. But what method would I 
call, anyway? I only care about calling methods on the stuff I put in the array, not 
the array itself. And I can use array syntax when I want to put things in and take 
things out of the array. 

ArrayList ： Is that so? You mean to tell me you actually removed something from an 
array? (Sheesh, where do they train you guys? Mcjava’s?) 

HeadFirst: Of course I take something out of the array. I say Dog d = dogArray[l] 
and I get the Dog object at index 1 out of the array. 


ArrayList ： Allright, I 5 11 try to speak slowly so you can follow along. You were not, 

I repeat not, removing that Dog from the array. All you did was make a copy of the 
reference to the Dog and assign it to another Dog variable. 

HeadFirst: Oh, I see what you’re saying. No I didn’t actually remove the Dog 
object from the array. It’s still there. But I can just set its reference to null, I guess. 

ArrayList ： But I’m a first-class object, so I have methods and I can actually, you 
know, do things like remove the Dog’s reference from myself, not just set it to null. 
And I can change my size, dynamically (look it up). Just try to get an array to do that! 

HeadFirst ： Gee, hate to bring this up, but the rumor is that you’re nothing more 
than a glorified but less-efficient array. That in fact you’re just a wrapper for an 
array, adding extra methods for things like resizing that I would have had to write 
myself. And while we’re at it ^ you can’t even hold primitives'. Isn’t that a big limitation? 

ArrayList ： I can’t believe you buy into that urban legend. No, I am not]\x^t a less- 
efficient array. I will admit that there are a few extremely rare situations where an 
array might be just a tad, I repeat, tad bit faster for certain things. But is it worth the 
miniscule performance gain to give up all this power. Still, look at all this flexibility • And 
as for the primitives, of course you can put a primtive in an ArrayList, as long as it’s 
wrapped in a primitive wrapper class (you’ll see a lot more on that in chapter 10). 
And as of Java 5.0, that wrapping (and unwrapping when you take the primitive out 
again) happens automatically. And allright, I’ll acknowledge that yes, if you’re using an 
ArrayList of primitives, it probably is faster with an array, because of all the wrapping 
and unwrapping, but still... who really uses primitives these days? 

Oh, look at the time! I’m late for Pilate 、 We’ll have to do this again sometime. 


you are here ► 135 


difference between ArrayList and array 

Comparing ArrayList to a regular array 


ArrayList 


regular array 



Notice how with ArrayList, you’re working 
with an object of type ArrayList, so you’re just 
invoking regular old methods on a regular old 
object, using the regular old dot operator. 


With an array, you use special array syntax (like 
myList[0] = foo) that you won’t use anywhere 
else except with arrays. Even though an 
array is an object, it lives in its own special 
world and you can’t invoke any methods on 
it, although you can access its one and only 
instance variable, length. 
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Comparing ArrayList to a regular array 
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① A plain old array has to know its 
size at the time it’s created. 

But for ArrayList, you just make an object of 
type ArrayList. Every time. It never needs to 
know how big it should be, because it grows 
and shrinks as objects are added or removed. 



new String[2] Kccds a 


new ArrayList<String>() 

No siz^ \r 

jivc i*t a 


c<\ui\rcd (al*thou^h you 
siz^ i -r you to). 


tav\ 


② To put an object in a regular array ， 
you must assign it to a specific 
location. 

(An index from 0 to one less than the length of 
the array.) 

myList[1] = b; 


If that index is outside the boundaries of the 
array (like, the array was declared with a size of 
2, and now you’re trying to assign something 
to index 3)，it blows up at runtime. 

With ArrayList, you can specify an index us¬ 
ing the add(anlnt, anObject) method, or you 
can just keep saying add(anObject) and the 
ArrayList will keep growing to make room for 
the new thing. 


myList.add(b); 

又 


" 0 ^dcx. 


⑤ Arrays use array syntax that’s not 
used anywhere else in Java. 

But ArrayLists are plain old Java objects, so 
they have no special syntax. 

myList[1] 

TV^c avvav Wa 戊中 [] ayrC 

used only ^ov arrays. 


)ArrayLists in Java 5.0 are 
parameterized. 

We just said that unlike arrays, ArrayLists 
have no special syntax. But they do use 
something special that was added to Java 5.0 
Tiger — parameterized types. 

ArrayList<String> 

The ih bvci^kcts is 3 

pa\ramclc\r w A^ayLisl<Stv-m3> simply u a 
list J S-t\rmgs w , as opposed io Av-v-ayLis-t<Dog> 

whi 乙 h list o( Po^s W . 

Prior to Java 5.0, there was no way to declare 
the type of things that would go in the 
ArrayList, so to the compiler, all ArrayLists 
were simply heterogenous collections of 
objects. But now, using the <typeGoesHere> 
syntax, we can declare and create an 
ArrayList that knows (and restricts) the 
types of objects it can hold. We’ll look at the 
details of parameterized types in ArrayLists 
in the Collections chapter, so for now, don’t 
think too much about the angle bracket <> 
syntax you see when we use ArrayLists. Just 
know that it’s a way to force the compiler to 
allow only a specific type of object (the type in 
angle brackets) in the ArrayList. 
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the buggy DotCom code 


prep code test code 


real code 


Let's fix the PotCom code. 

Remember, this is how the 


public class DotCom { 

int[] locationCells; 
int numOfHits = 0; 

public void setLocationCells(int[] Iocs) { 

locationCells = Iocs; 

} 

public String checkYourself(String stringGuess) { 

int guess = 工 nteger.parselnt(stringGuess); 
String result = ''miss ”； 



jgy version looks ： 






for (int cell : locationCells) { 


if (guess = 

=cell) { 

result = 

''hit"; 

numOfHits++; 


i 去 ; j". 

h3d 3l ^dy bcc 3 h C 〜士 々// 


break; 

} 

} // out of the loop 


if (numOfHits == locationCells.length) { 
result = ''kill ”； 

} 

System.out.println(result); 
return result; 

} // close method 
} // close class 
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real code 
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New and improved PotCom class 


〆 ^ ihis li hc ^ 

import java. util. ArrayList; ^boui 


public class DotCom 



private ArrayLi S t<String , > locationCells; 

// private int numOfHits; 

// don't need that now 


从 c 


〕 arionue 丄丄 s; 

卿—一 — 以一 
%, 

ayLi 


public void setLocationCeiis (Ar , rayList<String> loc) { 
locationCells = loc; 




public String checkYourself(String userlnput) 
String result = 


miss 


1^ 

vcW^ s a 

int index = locationCells.indexOf(userlnput )‘ 


絨 sss() 


if (index >= 0) { 


七 


locationCells.remove(index); 


^r- 


d ^iicly i h 


So ^Ct^ovc ' 1 


if (locationCells.isEmpty()) 

result = ''kill ”； 

} else { 

result = ''hit ”； 

} // close if 

// close outer if 


v/as k»IIm5 Wow! 


return result, 
} // close method 
// close class 
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making the DotComBust 


Let's build the REAL game: 
"Siwk a Pot Com" 


We’ve been working on the ‘simple’ version, but now 
let’s build the real one. Instead of a single row, we’ll 
use a grid. And instead of one DotCom, we’ll use 
three. 


Goal: Sink all of the computer’s Dot Corns in the 
fewest number of guesses. You’re given a rating level 
based on how well you perform. 

Setup: When the game program is launched, the 
computer places three Dot Corns, randomly, on the 
virtual 7x7 grid. When that’s complete, the game 
asks for your first guess. 


How you play: We haven’t learned to build a GUI 
yet, so this version works at the command-line. The 
computer will prompt you to enter a guess (a cell), 
which you’ll type at the command-line (as “A3” ， “C5 ”， 
etc.). In response to your guess, you’ll see a result at 
the command-line, either “hit” ， “miss”，or “You sunk 
Pets.com” (or whatever the lucky Dot Com of the day 
is). When you’ve sent all three Dot Corns to that big 
404 in the sky, the game ends by printing out your 
rating. 


7 )< 7 grid 




' s*t3v**ts a*t zjcvo, like Java arrays 


You’re going to build the 
Sink a Dot Com game, with 
a 7 x 7 grid and three 
Dot Corns. Each Dot Com 
takes up three cells. 


part of a game interaction 


| File Edit 

Window Help Sell 


% java 

DotComBust 

Enter 

a 

guess 

A3 

miss 




Enter 

a 

guess 

B2 

miss 




Enter 

a 

guess 

C4 

miss 




Enter 

a 

guess 

D2 

hit 




Enter 

a 

guess 

D3 

hit 




Enter 

a 

guess 

D4 

Ouch! 

You sunk 

Pets.com : ( 

kill 




Enter 

a 

guess 

B4 

miss 




Enter 

a 

guess 

G3 

hit 




Enter 

a 

guess 

G4 

hit 




Enter 

a 

guess 

G5 

Ouch! 

You sunk 

AskMe. com : ( 
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What needs to change? 

We have three classes that need to change: the 
DotCom class (which is now called DotCom instead of 
SimpleDotCom), the game class (DotComBust) and the 
game helper class (which we won’t worry about now). 

❹ DotCom class 

© Add a name variable 

to hold the name of the DotCom 
(“Pets.com” ， “Go2.com” ， etc.) so each Dot- 
Com can print its name when it’s killed (see 
the output screen on the opposite page). 

o DotComBust class (the game) 

© Create three DotComs instead of one. 

© Give each of the three DotComs a name. 

Call a setter method on each DotCom 
instance, so that the DotCom can assign the 
name to its name instance variable. 


DotComBust class continued... 

© Put the DotComs on a grid rather than 
just a single row, and do it for all three 
DotComs. 

This step is now way more complex than 
before, if we’re going to place the DotComs 
randomly. Since we’re not here to mess 
with the math, we put the algorithm for 
giving the DotComs a location into the 
GameHelper (Ready-bake) class. 

© Check each user guess with all three 
DotComs ， instead of just one. 

© Keep playing the game (i.e accepting 
user guesses and checking them with the 
remaining DotComs) until there are no more 
live DotComs. 

© Get out of main. We kept the simple one in 
main just to... keep it simple. But that’s not 
what we want for the real game. 


3 Classes: 



A a nd to make b 0f 


and plays 




DotComBust 


DotCom 


GameHelper 

The game class. 

Makes DotComs, 
gets user input, 
plays until all Dot- 
Coms are dead 


The actual 

DotCom objects. 

DotComs know their 
name, location, and 
how to check a user 
guess for a match. 


The helper class 

(Ready-Bake). 

It knows how to 
accept user com¬ 
mand-line input, 
and make DotCom 
locations. 


5 Objects: 



DotComBust 



DotCom 



GameHelper 


Plus 4 

ArrayLists ： 1 for 
the DotComBust 
and 1 for each 
of the 3 DotCom 
objects. 
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detailed structure of the game 


Who does what m the PotComPust game 

(and when) 



DotComBust 


The game 
class. 



object 


The main() method 
in the DotComBust 
class instantiates the 
DotComBust object that 
does all the game stuff. 




instantiates 


GameHelper 

object 


DotComBust 

object 


The DotComBust (game) 
object instantiates an 
instance of GameHelper, 
the object that will help 
the game do its work. 




GameHelper 

object 


DotComBust 

object 


ArrayList object (to 
hold DotCom objects) 


The DotComBust object 
instantiates an ArrayList 
that will hold the 3 DotCom 
objects. 
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dotCofsList 


helper 


DotComBust 

object 


ArrayList object to 
hold DotCom objects 


DotCom 

objects 


The DotComBust object 
creates three DotCom 
objects (and puts them in 
the ArrayList) 



dotComfsList 


'cells 




The DotComBust object gives each of the Dot- 
Com objects a location (which the DotComBust 
got from the helper object) like M A2”, M B2”, 
etc. Each DotCom object puts his own three 
location cells in an ArrayList 


ArrayList object to 
hold DotCom objects 


The DotComBust object asks the 
helper object for a location for a 
DotCom (does this 3 times, one for 
each DotCom) 


tion 


DotComBust 

object 


DotCom 

objects 


ArrayList 

object 


ArrayList object 
(to hold DotCom 
cell locations) 


ArrayList 

object 



dotComfsList 


The DotComBust object asks the helper 
object for a user guess (the helper 
prompts the user and gets input from 
the command-line) ^ 


The DotComBust object loops through the list 
of DotComs, and asks each one to check the user 
guess for a match. The DotCom checks its locations 
ArrayList and returns a result ( 、、 hit' M miss ,, / etc.) 


DotComBust 

object 

And so the game continues... get¬ 
ting user input, asking each DotCom 
to check for a match, and continuing 
until all DotComs are dead 




ArrayList object 
1 (to hold DotCom 


ArrayList object to 
hold DotCom objects 


DotCom 

objects 


cell locations) 


ArrayList 

object 


ArrayList 

object 
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the DotComBust class (the game) 



DotComBust 

GameHelper helper 
ArrayList dotComsList 
int numOfGuesses 

setUpGame() 

startPlaying() 

checkUserGuess() 

finishGame() 


Prep code for the real PotComPust class 

The DotComBust class has three main jobs: set up the game, play the game 
until the DotComs are dead, and end the game. Although we could map 
those three jobs directly into three methods, we split the middle job (play the 
game) into two methods, to keep the granularity smaller. Smaller methods 
(meaning smaller chunks of functionality) help us test, debug, and modify 
the code more easily. 


Variable 


DECLARE and instantiate the GameHelper instance variable, named helper. 

DECLARE and instantiate an ArrayList to hold the list of DotComs (initially three) Call it 

dotComsList. 


Declarations 


DECLARE an int variable to hold the number of user guesses (so that we can give the user a 
score at the end of the game). Name it numOfGuesses and set it to 0. 


Method 

Declarations 


DECLARE a setUpGame() method to create and initialize the DotCom objects with names 
and locations. Display brief instructions to the user 

DECLARE a startPlaying() method that asks the player for guesses and calls the 
checl<UserGuess() method until all the DotCom objects are removed from play. 

DECLARE a checkUserGuess() method that loops through all remaining DotCom objects and 
calls each DotCom object’s checl<Yourself() method. 

DECLARE a finishGame() method that prints a message about the user’s performance, based 
on how many guesses it took to sink all of the DotCom objects. 


Method 

Implementations 


METHOD: void setUpCamef) 

II make three DotCom objects and name them 

CREATE three DotCom objects. 

SET a name for each DotCom. 

ADD the DotComs to the dotComsList (the ArrayList). 

REPEAT with each of the DotCom objects in the dotComsList array 

CALL the placeDotComf) method on the helper object, to get a randomly-selected 
location for this DotCom (three cells, vertically or horizontally aligned, on a 7 X 7 grid). 

SET the location for each DotCom based on the result of the placeDotCom() call. 

END REPEAT 

END METHOD 
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prep code ― st code 


real code 


Method implementations continued: 


METHOD: void startPlayingf) 

REPEAT while any DotComs exist 

GET user input by calling the helper getilserlnput() method 
EVALUATE the user’s guess by checkUserGuess() method 
END REPEAT 
END METHOD 


get to know the Java API 


METHOD: void checkUserCuess(5tring userGuess) 

II find out if there's a hit (and kill) on any DotCom 

INCREMENT the number of user guesses in the numOfGuesses variable 

SET the local result variable (a String) to "miss", assuming that the user’s guess will be a miss. 

REPEAT with each of the DotObjects in the dotComsList array 

EVALUATE the user’s guess by calling the DotCom object’s checkYourself() method 
SET the result variable to ‘‘hit’’ or‘‘kill’’ if appropriate 
IF the result is "kill", REMOVE the DotCom from the dotComsList 
END REPEAT 

DISPLAY the result value to the user 
END METHOD 


METHOD: void fmishCame() 

DISPLAY a generic "game over’’ message, then: 
IF number of user guesses is small, 

DISPLAY a congratulations message 

ELSE 

DISPLAY an insulting one 
END IF 

END METHOD 


厂 rf^l^arpen your pencil 

How should 


we go from prep code to the 
final code? First we start with test code, and 
then test and build up our methods bit by 
bit. We won’t keep showing you test code 
in this book, so now it’s up to you to think 
about what you’d need to know to test these 


methods. And which method do you test 
and write first? See if you can work out some 
prep code for a set of tests. Prep code or 
even bullet points are good enough for this 
exercise, but if you want to try to write the 
real test code (in Java), knock yourself out. 
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the DotComBust code (the game) 



real code 


import j ava.util.*; 
public class DotComBust { 

(private GameHelper helper = new GameHelper(); 

private ArrayList<DotCom> dotComsList = new ArrayList<DotCom>() 
f private int numOfGuesses = 0; 

private void setUpGaitie () { 

// first make some dot corns and give them locations 
DotCom one = new DotCom(); 
one . setName (''Pets • com"); 

DotCom two = new DotCom(); 
two . setName (''eToys • com"); 

DotCom three = new DotCom() 
three . setName ( 、 'Go2 • com ’’）； 
dotComsList.add(one); 
dotComsList.add(two); 
dotComsList.add(three); 


cr^arpen your pencil 


Annotate the code 
yourself! 

Match the 
annotations at the 
bottom of each page 
with the numbers 
in the code. Write 
the number in the 
slot in front of the 
corresponding 
annotation. 

You’ll use each 
annotation just once, 
and you’ll need all of 
the annotations. 




System. out. print In (''Your goal is to sink three dot corns .”） 

System, out .println (''Pets . com, eToys.com, Go2.com ”）； 

System. out. print In (''Try to sink them all in the fewest number of guesses ’’）； 

for (DotCom dotComToSet : dotComsList) { 

ArrayList<String> newLocation = helper.placeDotCom(3); 

dotComToSet.setLocationCells(newLocation); 

} // close for loop 

// close setUpGame method 


⑥ 


private void startPlaying () { 

while(!dotComsList.isEmpty()) { 

String userGuess = helper • getUserlnput (''Enter a guess ’’）； 
checkUserGuess(userGuess); ⑤ 

} // close while 

finishGame (); ⑩ 

} // close startPlaying method 




以 ㈣ 二 _ 
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get to know the Java API 



real code 


private void cllGCkUSGrGuGSS (String userGuess) 
numOfGuesses++; ⑪ 


String result 


miss 


；© 


⑪ 


for (DotCom dotComToTest : dotComsList) { 

result = dotComToTest.checkYourself(userGuess); 
if (result • equals (''hit”））{ 
break; ^ 5 ^ 


⑭ 


if (result • equals (''kill") ) { 

dotComsList.remove(dotComToTest); 
break; 


© 


Whatever you do, 
DON 9 T turn the 
page! 

Not until you’ve 
finished this 
exercise. 

Our version is on 
the next page. 


} // close for 

System.out.println(result); ^7) 

} // close method 

private void finishGaiHG ( ) { 

System.out.println(''All Dot Corns are dead! Your stock is now worthless•〃）J 
if (numOfGuesses <= 18) { 

System • out • println (''It only took you '' + numOfGuesses + '' guesses .’’）； 
System. out. println ('' You got out before your options sank .’’）； 

} else { 

System. out. println (''Took you long enough. ''+ numOfGuesses + '' guesses .’’）； 
System. out. println (''Fish are dancing with your options .’’）； 

} 

} // close method 



public static void main (String[] args) - 
DotComBust game = new DotComBust(); 
game.setUpGame() 
game.startPlaying() 

} // close method 
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the DotComBust code (the game) 



real code 


import java•util.*; 
public class DotComBust { 




private GameHelper helper = new GameHelper(); 
private ArrayList<DotCom> dotComsList = new ArrayList<DotCom>() 
private int numOfGuesses = 0; 

private void setUpGame () { 

// first make some dot corns and give them locations 
DotCom one = new DotCom(); 
one . setName (''Pets • com"); 

DotCom two = new DotCom(); 
two . setName (''eToys • com"); 

DotCom three = new DotCom() 
three . setName ( 、 'Go2 • com"); 
dotComsList.add(one); 
dotComsList.add(two); 
dotComsList.add(three); 




Make a 於 

OKUV PotCom 


•m 


: ew 灼 awes, 

i\\t Av-v-a7Ust 


Pvm 七 kvic-f 

ms*tv-ufc*t'ioir\s -fov- user- 


System. out. print In (''Your goal is to sink three dot corns. 〃）； 

System, out .println (''Pets . com, eToys.com, Go2.com ”）； 

System.out.printIn(''Try to sink them all in the fewest number of guesses"); 


for (DotCom dotComToSet : dotComsList) 


[ < — Rcpca-t W»-tK Po-tCom m -tKc list 

/\sk i\\t V\el\>cv fov* a 

ArrayList<String> newLocation = helper. placeDotCom (3) ; PotCom loda ot\ 

A^ayUs-t o\ S*bri 呼 ) • 


dotComToSet.setLocationCells(newLocation) 

} // close for loop 

// close setUpgame method 




private void startPlaying () { ,, 

y AsMas-t^ PotCo. l-.st |S 1^0 W !me ⑽’/•七 s 

while ( ! dotComsList. isEmpty () ) same 3s (do*tCow»sL»s*t*^ se ’ 

String userGuess = helper • getUserlnput (''Enter a guess’’）；^^ k 'ASCV* 

checkUserGuess(userGuess);^ , 

hi w 

} // close while 

finishGame () ; ^ Call ou\r oy/h -fihish^a^c meikod. 

} // close startPlaying method 
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real code 


get to know the Java API 


private void ch6CkUS6rGuesS (String userGuess) 
numOfGuesses++; 

String result = ''miss ”； < 


for (DotCom dotComToTest : dotComsList) 


result = dotComToTest.checkYourself(userGuess); 


心⑽跣如 神 bw of ^ 邮从 c 咖心 州 adc 

assume a Ucss -told otKc^sc 

vc\>ca-t all Po-tCo^s m i\\t l»s*t 


if (result. equals (''hit^)) 

get ou-t o( -th c 


ask 如 VdC T *to 气炉 ^ 

^uess, lookm^ *fov- d Wi*t (ov- kill^ 


ih 


PO，ht 


break; 

} 

if (result • equals (''kill") ) { 

dotComsList.remove(dotComToTest); 
break; 


^ 9 U / S dead, so -bkc him out of th c 

Voices I,Si i hc , 9ct out ^ ihc 


} // close for 

System.out.println(result); 

// close method 


priivt the ircsul-t -fov- the 


usev* 


priivt a message tdlmg the 

的饮 how he did ih 七 he 

/ 


private void finishGaiHG ( ) { 

System. out. println (''All Dot Corns are dead! Your stock is now worthless .’’）； 
if (numOfGuesses <= 18) { 

System • out • println (''It only took you '' + numOfGuesses + '' guesses .’’）； 
System. out. println ('' You got out before your options sank .’’）； 

} else { 

System. out. println (''Took you long enough. ''+ numOfGuesses + '' guesses .’’）； 
System. out. println (''Fish are dancing with your options ’’）； 

} 

} // close method 



public static void main (String[] args) 
DotComBust game = new DotComBust(); 


game.setUpGame(); 
game.startPlaying(); 

// close method 






ie " Ue 9^e obi e£ i i , 
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the DotCom code 



real code 


The final version ot the 
PotCom class 


import j ava.util.*; 

public class DotCom { 

private ArrayList<String> locationCells 
private String name; 



Po-tCo^s variables ： 

-Po-tCom^ irvaw'C 


Y\S 


public void setLocationCells (ArrayList<String> loc) 
locationCells = loc; 


A sc*t*tcv- mc*tKod updates 
{}\t Po-tCom^s lo£.a*t'iO\r\. 
(Random lotatio^ ^ovWlcd by 
七 V^c ^a^cttclpcv- pla^cPotCom 
method) 


() 


public void setName (String n)^_ 
name = n; 


ouv- 


bdsi 6 stiicr r^ci\\od 


public String checkYourself (String userlnput) { 
String result = ''miss ”； 

int index = locationCells•indexOf(userlnput); 
if (index >= 0) { 

locationCells.remove(index); 


TKc A 代 ayUis 七 ) method m 

achoJ 1+ ^ 3 ucss -.s the 

m 如 A^Us-t, 

Will vc-turn rb A^ayUs-t Uaho^ Mr 
⑽七 , mdc^( ) W»H 代 W - 1 . 


Usm^ ^vvayL-is^s v*cw>ovc( ) method *to delete ^v\ c^*tv*y» 




if (locationCells.isEmpty() 
result = ''kill ”； 

System. out. print In (''Ouch ! You sunk 
} else { 

result = ''hit ”； 

} // close if 

} // close if 
return result; 

^c-tuv-h ： 

} // close method 
// close class 


Usm^ isEw\f*b/( ) *tx> see all 

locations iiavc a^cssed 


name 
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Super Powerful Poolean Expressions 


So far, when we’ve used boolean expressions for our loops or 
if tests,they’ve been pretty simple. We will be using more 
powerful boolean expressions in some of the Ready-Bake code 
you’re about to see, and even though we know you wouldn’t 
peek, we thought this would be a good time to discuss how to 
energize your expressions. 

‘And’ and g Or J Operators ( &&， || ) 

Let’s say you’re writing a chooseCameraO method, with lots of rules 
about which camera to select. Maybe you can choose cameras 
ranging from $50 to $1000, but in some cases you want to limit the 
price range more precisely. You want to say something like: 

If the price range is between $300 and $400 then choose X.’ 

if (price >= 300 && price < 400) { 
camera = "X "; 


Let’s say that of the ten camera brands available, you have some 
logic that applies to only a few of the list: 

if (brand.equals("A” | | brand• equals("B” ) { 
// do stuff for only brand A or brand B 


Boolean expressions can get really big and complicated: 

if ((zoomType.equals("optical") && 

(zoomDegree >= 3 && zoomDegree <= 8)) 
(zoomType.equals("digital") && 

(zoomDegree >= 5 && zoomDegree <= 12))) { 
//do appropriate zoom stuff 

} 

If you want to get rea//y technical, you might wonder about the 
precedence of these operators. Instead of becoming an expert 
in the arcane world of precedence, we recommend that you use 
parentheses to make your code clear. 


Not equals (!= and !) 

Let’s say that you have a logic like,"of the ten available 
camera models, a certain thing is true for oil but one." 

if (model != 2000) { 

//do non-model 2000 stuff 

} 

or for comparing objects like strings... 

if (! brand. equals ( "X ,r )) { 

// do non-brand X stuff 

} 

Short Circuit Operators (&&，||} 

The operators we’ve looked at so far, && and ||, are 
known as short circuit operators. In the case of &&, 
the expression will be true only if both sides of the && 
are true. So if the JVM sees that the left side of a && 
expression is false, it stops right there! Doesn't even 
bother to look at the right side. 

Similarly, with ||,the expression will be true if e/f/]erside is 
true, so if the JVM sees that the left side is true, it declares 
the entire statement to be true and doesn’t bother to 
check the right side. 

Why is this great? Let’s say that you have a reference 
variable and you’re not sure whether it’s been assigned 
to an object. If you try to call a method using this null 
reference variable (i.e.no object has been assigned), you’ll 
get a NullPointerException. So, try this: 

if (refVar != null && 

refVar.isValidType() ) { 

// do 'got a valid type" stuff 

} 

Non Short Circuit Operators ( & ， |} 

When used in boolean expressions, the & and | operators 
act like their && and || counterparts, except that 
they force the JVM to always check both sides of the 
expression. Typically, & and | are used in another context, 
for manipulating bits. 
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Ready-bake: GameHelper 


Read|-fcake 

Cade 


import j ava.io.*; 
import j ava.util.*; 



This is the helper class for the game. Besides the user input method 
(that prompts the user and reads input from the command-line), the 
helpers Big Service is to create the cell locations for the DotComs. 
If we were you, we*d just back away slowly from this code, except 
to type it in and compile it. We tried to keep it fairly small to you 
wouldrVt have to type so much, but that means it isn't the most 
readable code. And remember, you won’t be able to compile the 
DotComBust game class until you have this class. 


public class GameHelper { 


private 

private 

private 

private 

private 


static final String alphabet = ''abcdefg ”； 

int gridLength = 7; 

int gridSize = 49; 

int [] grid = new int[gridSize]; 

int comCount = 0; 


public String getUserlnput(String prompt) { 
String inputLine = null; 

System. out.print (prompt + '' ; 

try { 

BufferedReader is = new BufferedReader( 
new 工 nputStreamReader(System•in)); 
inputLine = is.readLine(); 

if (inputLine.length() == 0 ) return null; 
} catch (工 OException e) { 

System • out • println (''IOException : '' + e); 

} 

return inputLine.toLowerCase (); 


Fov dvcdi 七， you 州 i# 七 

*bry — dommcrrti 的七 he 

Sys 七 em ou 七 .pv’m 七 m 七 he 
pladcDo*tCorw( ) me 七 iiod ， jus*t 
七 o wa 七 i 七 y/ovkf TKcsc pvih 七 
statements will lc 七 you 
by giving you 七 lie lodation of 七 lie 
PotCor^s, but it will liclp you 七 cs 七 it 


public ArrayList<String> placeDotCom(int comSize) { 

ArrayList<String> alphaCells = new ArrayList<String>() 


String [] alphacoords = new String [comSize]; 

String temp = null; 

int [] coords = new int[comSize]; 

int attempts = 0 ; 

boolean success = false; 

int location = 0 ; 


// holds 'f 6 ^ type coords 
// temporary String for concat 
// current candidate coords 
// current attempts counter 
// flag = found a good location 
// current starting location 


9 


comCount++; 
int incr = 1 ; 

if ((comCount % 2) == 1) { 

incr = gridLength; 


// nth dot com to place 
// set horizontal increment 
// if odd dot com (place vertically) 
// set vertical increment 


while ( !success & attempts++ < 200 ) { 

location = (int) (Math.random() * gridSize); 

//System, out .print ('' try '、 + location) / 
int x = 0; 
success = true; 

while (success & & x < comSize) { 
if (grid[location] == 0) { 


// main search loop (32) 

// get random starting point 

// nth position in dotcom to place 
// assume success 

// look for adjacent unused spots 
// if not already used 
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Read|-fcake 

Cade 


^ameHclper class code contiKiued... 


coords[x++] 

= location; 

// 

save location 


location += 

: incr; 

// 

try 'next 71 adjacent 

if (location >= gridSize) { 

// 

out of bounds 

- 'bottom' 

success = 

: false; 

// 

failure 


I 

if (x>0 && 

(location % gridLength == 0) ) { 

// 

out of bounds 

- right edge 

success = 

1 

: false; 

// 

failure 


/ 

else { 


// 

found already 

used location 

// System. 

out .print ('' used '' + location); 




success — 

false; 

// 

failure 




// 

end while 



int x = 0; 
int row = 0 ; 
int column = 0 ; 

// System, out .printIn ( yy \n^); 
while (x < comSize) { 
grid[coords[x]] = 1 ; 

row = (int) (coords[x] / gridLength); 

column = coords[x] % gridLength; 

temp = String.valueOf(alphabet.charAt(column)); 


// turn location into alpha coords 


// mark master grid pts. as 'used' 
// get row value 
// get numeric column value 
// convert to alpha 


alphaCells.add(temp.concat( 工 nteger•toString(row))); 
x++; 

// System, out .print ( yy coord 、 '+x+" = '、+ alphaCells . get (x-1)); 


// System, out .println ( 、 '\n"); 


return alphaCells; 
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API packages 


Usmg the Library (the Java API) 


You made it all the way through the DotComBust game, 
thanks to the help of ArrayList. And now, as promised, 
it’s time to learn how to fool around in theja ~ 1:1 - 



In the Java API, classes 
are grouped into packages 


To use a class in the API, you 
have to know which package 
the class is in. 

Every class in the Java library belongs to a package. 
The package has a name, like javax.swing (a 
package that holds some of the Swing GUI classes 
you’ll learn about soon). ArrayList is in the package 
called java.Util, which surprise surprise, holds a 
pile of utility classes. You’ll learn a lot more about 
packages in chapter 16, including how to put your 
own classes into your own packages. For now though, 
we’re just looking to use some of the classes that come 
with Java. 

Using a class from the API, in your own code, is 
simple. You just treat the class as though you wrote 
it yourself... as though you compiled it, and there it 
sits, waiting for you to use it. With one big difference: 
somewhere in your code you have to indicate the full 
name of the library class you want to use, and that 
means package name + class name. 

Even if you didn’t know it, you^ve already been using 
classes from a package. System (System, out. prin tin), 
String, and Math (Math.random ()), all belong to the 
jdva.lang package. 
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get to know the Java API 


You have to know the fujl name* 
of the class you want to use in 
your code. 


Array Li st is not the full name of ArrayList, just as ‘Kathy’ 
isn’t a full name (unless it’s like Madonna or Cher, but we 
won’t go there). The full name of ArrayList is actually: 

java.util.ArrayList 



pa 匕 k 吵 








You have to tell Java which ArrayList you 
want to use. You have two options: 

❹ IMPORT 

Put an import statement at the top of your source code file: 

import java.util.ArrayList; 
public class MyClass {... } 


_t|ierei£ireaiP 

Dumb Questions 

Why does there have to 
be a full name? Is that the only 
purpose of a package? 

A. 

Jr \ m Packages are important 
for three main reasons. First, they 
help the overall organization of a 
project or library. Rather than just 
having one horrendously large 
pile of classes, they’re all grouped 
into packages for specific kinds 
of functionality (like GUI, or data 
structures, or database stuff, etc.) 

Second, packages give you a name¬ 
scoping, to help prevent collisions 
if you and 12 other programmers 
in your company all decide to 
make a class with the same name. 

If you have a class named Set and 
someone else (including the Java 
API) has a class named Set,you 
need some way to tell the JVM 
which Set class you're trying to use. 


OR 


❺ TYPE 

Type the full name everywhere in your code. Each time 
you use it. Anywhere you use it. 


Third, packages provide a level of 
security, because you can restrict 
the code you write so that only 
other classes in the same package 
can access it. You’ll learn all about 
that in chapter 16. 

OK, back to the name 


When you declare and/or instantiate it: 
java.util.ArrayList<Dog> list = 


collision thing. How does a full 
name really help? What's to 

new java.util. ArrayList<Dog> () ; p reV ent two people from giving a 

class the same package name? 


When you use it as an argument type: 

public void go(java.util.ArrayList<Dog> list) { } 

When you use it as a return type: 

public java.util.ArrayList<Dog> foo() {...} 


A ： 


Java has a naming convention 
that usually prevents this from 
happening, as long as developers 
adhere to it. We’ll get into that in 
more detail in chapter 16. 


*Unless the class is in the java.lang package. 
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when arrays aren’t enough 


Where’d that come from? 

(or，what does it mean when 
a package starts with javax?) 

In the first and second versions of Java (1.02 
and 1.1), all classes that shipped with Java (in 
other words, the standard library) were in packages 
that began with yava.There was always java.lang, of course 
— the one you don’t have to import. And there was java.net, 
java.io, java.util (although there was no such thing as ArrayList 
way back then), and a few others, including the java.awt 
package that held GUI-related classes. 

Looming on the horizon, though, were other packages not 
included in the standard library.These classes were known as 
extensions, and came in two main flavors: standard, and not 
standard. Standard extensions were those that Sun considered 
official, as opposed to experimental, early access, or beta 
packages that might or might not ever see the light of day. 

Standard extensions, by convention, all began with an 'x' 
appended to the regular java package starter. The mother of all 
standard extensions was the Swing library. It included several 
packages, all of which began with javax.swing. 

But standard extensions can get promoted to first-class, ships- 
with-Java, standard-out-of-the-box library packages. And that’s 
what happened to Swing, beginning with version 1.2 (which 
eventually became the first version dubbed Java 2’). 

"Cool’;everyone thought (including us)."Now everyone who has 
Java will have the Swing classes, and we won’t have to figure 
out how to get those classes installed with our end-users.” 

Trouble was lurking beneath the surface, however, because 
when packages get promoted, well of COURSE they have to 
start with java, not javax. Everyone KNOWS that packages in 
the standard library don’t have that "x", and that only extensions 
have the"x ’： So, just (and we mean just) before version 1.2 
went final. Sun changed the package names and deleted the 
"x” (among other changes). Books were printed and in stores 
featuring Swing code with the new names. Naming conventions 
were intact. All was right with the Java world. 

Except the 20,000 or so screaming developers who realized 
that with that simple name change came disaster! All of their 
Swing-using code had to be changed! The horror! Think of all 
those import statements that started with javax... 

And in the final hour, desperate, as their hopes grew thin, the 
developers convinced Sun to "screw the convention, save our 
code’: The rest is history. So when you see a package in the 
library that begins with javax, you know it started life as an 
extension, and then got a promotion. 



_ BULLET POINTS_ 

■ ArrayList is a class in the Java API. 

■ To put something into an ArrayList, use add(). 

■ To remove something from an ArrayList use 

remove(). 

■ To find out where something is (and if it is) in an 
ArrayList, use indexOf(). 

■ To find out if an ArrayList is empty, use 

isEmpty(). 

■ To get the size (number of elements) in an 
ArrayList, use the size() method. 

■ To get the length (number of elements) in a 
regular old array, remember, you use the length 

variable. 

■ An ArrayList resizes dynamically to what¬ 
ever size is needed. It grows when objects 
are added, and it shrinks when objects are 
removed. 

■ You declare the type of the array using a type 
parameter, which is a type name in angle 
brackets. Example: ArrayList<Button> means 
the ArrayList will be able to hold only objects of 
type Button (or subclasses of Button as you’ll 
learn in the next couple of chapters). 

■ Although an ArrayList holds objects and not 
primitives, the compiler will automatically “wrap” 
(and “unwrap” when you take it out) a primi¬ 
tive into an Object, and place that object in the 
ArrayList instead of the primitive. (More on this 
feature later in the book.) 

■ Classes are grouped into packages. 

■ A class has a full name, which is a combina¬ 
tion of the package name and the class name. 
Class ArrayList is really java.util.ArrayList. 

■ To use a class in a package other than java, 
lang, you must tell Java the full name of the 
class. 

■ You use either an import statement at the top of 
your source code, or you can type the full name 
every place you use the class in your code. 
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^tliereiaireJiP 0 

Dumb Questions 


vJ I Does import make my 
class bigger? Does it actually 
compile the imported class or 
package into my code? 

Perhaps you’re a C pro¬ 
grammer? An import is not the 
same as an include. So the 
answer is no and no. Repeat after 
me:"an import statement saves 
you from typing.’’That’s really it. 
You don’t have to worry about 
your code becoming bloated, or 
slower,from too many imports. 

An import is simply the way you 
give Java the full name of a class. 

OK, how come I never had 
to import the String class? Or 
System? 

Remember, you get the 
java.lang package sort of "pre- 
importecT’for free. Because 
the classes in java.lang are so 
fundamental, you don’t have to 
use the full name.There is only 
one java.lang.String class, and one 
java.Iang.System class, and Java 
darn well knows where to find 
them. 


Do I have to put my own 
classes into packages? How do I 
do that? Can I do that? 

In the real world (which 
you should try to avoid), yes, you 
will want to put your classes into 
packages. We’ll get into that in 
detail in chapter 16. For now, we 
won’t put our code examples in a 
package. 
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One more time, in the unlikely 
event that you don’t already 
have this down: 
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“Good to know there’s an ArrayList in 
the java, util package. But by myself，how 
would I have figured that outV’ 

- Julia, 31, hand model 


How to play with the API 

Two things you want to know: 

What classes are in the library? 



Once you find a class, how do 
you know what it can do? 




Browse a Book 



IN A NUTSHELL 


A Desktop Quick Reference 


O’REILLT lyatitl 



Use the HTML API docs 



Java 111 Z Plilfofiri 
Standard Ed. S.O 


c 


Overview 


I Package Claas U 轴 Trea 

FivHLa mr 


D*pncHd Iridts Hdp 


Jam rM I Fktfffnn ® 


All Ctau*a 



AU Cli«*a* 

AtejyaeWclXKi 


$ 



Abstract Docu rrwnl 


A&ag.ftctDocyrflftfiL | 


AjwaaLawKfiCachBuNoa 

AteffftBUgl 

Jnliyinrtiil _ ’ 



Java tu 2 Platform Sland^iind ICdHinn Sit 
API Specification 


ThU dociiHKiH N tIw API qicdfkaninn 2 Plaifnim ： S_iUfd EcUticwi JSil, 

Ilracriplkm 


Java 2 l J l»lfurm 

javiui|]plel 

PnivKkh Ihfr duLW> mukc ui \xppki uihJ llw 

.in .ippkl 试， In cfififiFTViintLMlt with its,iififiki 
ccHihrxl, 


Cornaim iiill af ihc diL^c* for w-w iPBerTaccs and far 

pai riling 其 nigMio unJ lEmigo. 

iavajiwl 


Pmvkkiii cb«ik?< far mlnr qwd 

iavHJi«l rdutulni^rcT 

Pfovkks i«ccrf*c^ mi daises for 坑 d^fta 

■ini 1 if ipIuiti -|irmilaj—Blii-ina 


158 chapter 6 





get to know the Java API 


o 



Browse a Book 


Flipping through a 
reference book is the 
best way to find out 
what’s in the Java 
library. You can easily 
stumble on a class that 
looks useful, just by 
browsing pages. 


d^ss 




6 \dSS 






jatxt ■ udlCi (itl^uv 

mt，d fly： java .teirt. DecimalFomiat .getGurrencyO, |av^. tec Dec Inna! FormatSynnhols .getCuirrftncy{). 
jaya .text.NumberfornnaLgatCLinencyt), Currency. 


don^^bh sGri^iiZDbfe conrpurabfe 

Thi$ cb$s rcpfcs^iics d^tc$ limes ;md lets you work with them in a sy^tem-indepen- 
dL-nt wuy. You can ca-die n Date by specifying ihe niimbor of millLSC-coEids from tliL- 
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favor of Lhe methods of the Calendar class. 


Object - 

- Date 
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public boolean before(java.util,Date 
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// Methods fmpkmentifj^ Comparsble 

i2 public int compareTo(Ot>j&cE a); 
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12 public Objeci cione(J 

public baolEjn equal&；Object obj]:— 
public int hnshCode{^ 
public SlringtoSCringO ； 

// Dspf^t&d Pubk W^Cftocfe 
« public ititgetDateO ； 
public intgetDayf ]： 
public int getRoursO ： 
public int getMinutesi：}; 
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public void setHoursiint hours): 
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❺ Use the HTML API docs 


Java comes with a fabulous set of online docs 
called, strangely, the Java API. They’re part of 
a larger set called the Java 5 Standard Edition 
Documentation (which, depending on what 
day of the week you look, Sun may be refer¬ 
ring to as “Java 2 Standard Edition 5.0”），and 
you have to download the docs separately; 
they don’t come shrink-wrapped with the Java 
5 download. If you have a high-speed internet 
connection, or tons of patience, you can also 
browse them atjava.sun.com. Trust us, you 
probably want these on your hard drive. 

The API docs are the best reference for get¬ 
ting more details about a class and its methods. 
Let’s say you were browsing through the refer¬ 
ence book and found a class called Calendar, 
in java.util. The book tells you a little about it, 
enough to know that this is indeed what you 
want to use, but you still need to know more 
about the methods. 


The reference book, for example, tells you 
what the methods take, as arguments, and what 
they return. Look at ArrayList, for example. 

In the reference book, you’ll find the method 
indexOf(), that we used in the DotCom class. 
But if all you knew is that there is a method 
called indexOf() that takes an object and re¬ 
turns the index (an int) of that object, you still 
need to know one crucial thing: what happens 
if the object is not in the ArrayList? Looking 
at the method signature alone won’t tell you 
how that works. But the API docs will (most of 
the time, anyway). The API docs tell you that 
the indexOf() method returns a -1 if the object 
parameter is not in the ArrayList. That’s how 
we knew we could use it both as a way to check 
if an object is even in the ArrayList, and to get 
its index at the same time, if the object was 
there. But without the API docs, we might have 
thought that the indexOf() method would 
blow up if the object wasn’t in the ArrayList. 


① 

1° ^ ^ Hsi i, U c 


0 O O ArrayList (Java 2 Platform SE 5.0) 


[◄ | {& ] | C ] [ + ] ^ http://java.sun.eom/j2se/l.5.0/docs/api/ 

- CV Google ■ 


iava.sql 

java.text 

iava.util 
iava.utll.concurrent 
|ava.util.concurrent.au 

iava.util.concurrent.loc 

java.util.|ar 
iava.util.lOQQina 


C' 


Queue 

RandomAccess 

Set 

SortedMap 

SortedSet 

Classes 

AbstractCollection 

AbstractList 

AbstractMap 
AbstractQueue 
AbstractSequentialLisl 

AbstractSet 

ArrayList 

Arrays 

BitSet 

Calendar 

Collections 

Currency 

Date 

Dictionary 


W 


Fields inherited from class java.utUAbstractList 


modCount 


Constructor Summary 


ArrayListf) 

Constructs an empty list with an initial capacity of 


ArrayList ( Collection<? extends E> c) 

Constructs a list containing the elements of the spa 
returned by the collection's iterator. 


ArrayList (int initialCapacity) 

Constructs an empty list with the specified initial cap 


Method Summary 


boolean 


void 


boolean 


boolean 


add(E o) 

Appends the specified element to the end af 




add (int index, E element) 

Inserts the specified element at the spcuificd f. 




addAll (Collection<? extends E> c) 


Appends all of the elements in the specified Collection to ihc end of this list, in 
the order that they arc returned by the specified Collection's Iterator. 


addAll (int index, Collection<? extends E> c) 


Inserts all of the elements in the specified Collection into this list, starting at the 
snorified nosition 
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Code Magnets 


Can you reconstruct the code snippets to make a 
working Java program that produces the output 
listed below? NOTE: To do this exercise, you need 
one NEW piece of info — if you look in the API for 
ArrayList, you’ll find a second add method that takes 
two arguments: 

add(int index. Object o) 

It lets you specify to the 
ArrayList whsrs to put the yi c auumy 


a. remove (2); 


add (0," 2 ero ") • 
add (l,"o ne ")/ 



public static void printAL(ArrayList< ring 〉 al) { | 

_ 一 —— ■ w -- 



public static voiu. mcij.ii votringLJ args) { 


System.out.print(element + 

} 

System, out. pr in tin '、）； 


)； 



three”）{ 
a .add (''four ’’）； 

% 

public 

class ArrayListMagnet { [__ 
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puzzle: crossword 



JavaC 减 s 7.0 


How does this crossword puzzle help you learn 
Java? Well, all of the words are Java related 
(except one red herring). 

Hint: When in doubt, remember ArrayList. 


Across 

1.1 can’t behave 

6. Or, in the courtroom 

7. Where it's at baby 

9. A fork’s origin 

12. Grow an ArrayList 

13. Wholly massive 

14. Value copy 

16. Notan object 

17. An array on steroids 

19. Extent 

21. 19’s counterpart 

22. Spanish geek snacks (Note: This has 
nothing to do with Java.) 

23. For lazy fingers 

24. Where packages roam 




1 



2 





3 


4 



5 










6 







7 





















8 




9 

10 






11 




12 




13 






14 

















15 




16 




17 










18 












19 






20 


21 


















22 





23 















24 









Down 

2. Where the Java action is. 

3. Addressable unit 

4. 2nd smallest 

5. Fractional default 

8. Library’s grandest 

10. Must be low density 

11. He’s in there somewhere 

15. As if 

16. dearth method 

18. What shopping and arrays have in common 

20. Library acronym 

21. What goes around 


More Hints: 


—e 6uj>|BUJ s,0|-| '8L 

!snAejj\/>|u!La-9L 

0A!i!iuUc| -0L ^ > 

lsn/(ejJV>|u!LU 
i0|qepuj0AO Z 


sjazjjadde Ljsmeds - BABf inoqe ion ZZ 

1U01X0 s,Abjjv 'Ll 

aAjljiuud U01UIU03 -gi 

lsn/(ejJV>|u!LlL Y 
sajiaueA 8 # L 


UMOQ 


SSOJDV 
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E^eccise Solutions 


File Edit Window Help Dance 


import java.util.*; 

1 

1 

public class ArrayListMagnet { 


public static void main (String[] args) { 



a = new Arra.yijisi:^i)i:nng> () 


a•add(0,” zero ”）； 
a.add(1,"one"); 


a•add(2 ^"two") 


a.add(3,"three ”）； 
printAL(a); 



public static void printAL(ArrayList<String> al) { 


for (String element : al) { 


System.out.print(element + 


Sys tem. out. println ('' ''); 
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puzzle answers 



c^harpen your pencil 


Across 


Write your OWN set of clues! Look at each word, and try to 
write your own clues.Try making them easier, or harder, or 
more technical than the ones we have. 


6. 

Down 

7. 2. 

9. 

3. 

12 . 

4. 

13. 

5. 

14. 

8. 

16. 

10 . 

17. 

11. 

19. 

15. 

21. 

16. 

22. 

18. 

23. 

20. 

24. 

21. 
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7 inheritance and polymorphism 



Better Living 
Objectville 


We were underpaid, ) 
overworked coders 'till we 
tried the Polymorphism Plan. But 
thanks to the Plan, our future is 
、 bright. Yours can be too! 


■ 


n 


Plan your programs with the future in mind. If there were a way to write 

Java code such that you could take more vacations, how much would it be worth to you? What 
if you could write code that someone else could extend, easily? And if you could write code 
that was flexible, for those pesky last-minute spec changes, would that be something you’re 
interested in? Then this is your lucky day. For just three easy payments of 60 minutes time, you 
can have all this. When you get on the Polymorphism Plan, you’ll learn the 5 steps to better class 
design, the 3 tricks to polymorphism, the 8 ways to make flexible code, and if you act now — a 
bonus lesson on the 4 tips for exploiting inheritance. Don’t delay, an offer this good will give 
you the design freedom and programming flexibility you deserve. It's quick, it's easy, and it’s 
available now. Start today, and we'll throw in an extra level of abstraction! 
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the power of inheritance 

Chair Wars Revisited... 


Remember way back in chapter 2, when Larry (procedural guy) 
and Brad (00 guy) were vying for the Aeron chair? Let’s look at 
a few pieces of that story to review the basics of inheritance. 

LARRY: You’ve got duplicated code! The rotate procedure 
is in all four Shape things. It’s a stupid design. You have to 
maintain four different rotate “methods”. How can that 
ever be good? 

BRAD: Oh, I guess you didn’t see the final design. Let me 
show you how OO inheritance works, Larry. 


Square 


Circle 


Triangle 


Amoeba 

rotate() 

playSoundQ 

rotatef) 

一 0 


rotatef) 

playSoundQ 


rotate 。 


o 

I looked at what all four 
classes have m common. 

4 ^ 


❺ 


They're Shapes, and they all rotate and 
playSouhd. So I abstracted out the 
common features and put them into a 
hew class called Shape. 



❺ 


superclass 


You can read this as, “Square inherits from Shape ”， 
“Circle inherits from Shape ”， and so on. I removed 
rotate() and playSound() from the other shapes, so now 
there’s only one copy to maintain. 

The Shape class is called the superclass of the other four 
classes. The other four are the subclasses of Shape. The 
subclasses inherit the methods of the superclass. In other 
words, if the Shape class has the functionality, then the 
subclasses automatically get that same functionality. 




subclasses 


Thewl Imked the other 
four shape classes to 
the wew Shape class, 
ma relationship called 
ihhcritahcc. 



Square 


Circle 


Triangle 


Amoeba 









166 








































inheritance and polymorphism 


What about the Amoeba rotate!)? 


How can amoeba do something different if it inherits its 
functionality from the Shape class? 

BRAD: That’s the last step. The Amoeba class overrides the 
methods of the Shape class. Then at runtime, the JVM knows 
exactly which rotate() method to run when someone tells the 


LARRY: Wasn’t that the whole problem here — that the amoeba shape 
had a completely different rotate and playSound procedure? 



Amoeba to rotate. 



o 

I made the Amoeba class override the 
rotated awd playSouhdO methods 
of the superclass Shape. Overriding 
just means that a subclass redefines 
owe of its inherited methods when 
it heeds to change or extend the 
behavior of that method. 


4 ^ 


Overriding methods 






How would you represent a house cat and a tiger, in an 
inheritance structure. Is a domestic cat a specialized 
version of a tiger? Which would be the subclass and 
which would be the superclass? Or are they both 
subclasses to some other class? 

How would you design an inheritance structure? What 
methods would be overridden? 


Think about it. Before you turn the page. 
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the way inheritance works 


Understanding Inheritance 

When you design with inheritance, you put common code in 
a class and then tell other more specific classes that the 
common (more abstract) class is their superclass. When one 
class inherits from another, the subclass inherits from the 
superclass. 

In Java, we say that the subclass extends the superclass. 

An inheritance relationship means that the subclass inherits 
the members of the superclass. When we say “members of 
a class” we mean the instance variables and methods. 

For example, if PantherMan is a subclass of SuperHero, the 
PantherMan class automatically inherits the instance variables 
and methods common to all superheroes including suit, 
tights, specialPower, useSpecialPower ( ) and 
so on. But the PantherMan subclass can add new 
methods and instance variables of its own, and it can 
override the methods it inherits from the superclass 
SuperHero. 


superclass 

(more abstract) 



SuperHero 

suit 
tights 

specialPower 


useSpecialPower() 

putOnSuit() 


subclasses 

(more specific) 



iKistaHce variables 

(state, attributes) 

methods 

(behavior) 






PantherMan 


useSpecialPower() 

putOnSuitQ 


Overriding 

methods 



FriedEggMan doesn’t need any behavior that’s unique, 
so he doesn’t override any methods. The methods and 
instance variables in SuperHero are sufficient. 
PantherMan, though, has specific requirements for his suit 
and special powers, so useSpecialPower () and 
putOnSuit () are both overridden in the PantherMan 
class. 


Instance variables are not overridden because they 
don’t need to be. They don’t define any special behavior, so a 
subclass can give an inherited instance variable any value it 
chooses. PantherMan can set his inherited tights to 
purple, while FriedEggMan sets his to white. 
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inheritance and polymorphism 


An inheritance example: 

public class Doctor { 

boolean worksAtHospital; 

void treatPatient () { 

// perform a checkup 


public class FamilyDoctor extends Doctor { 

boolean makesHouseCalls; 
void giveAdvice() { 

// give homespun advice 


public class Surgeon extends Doctor{ 

void treatPatient () { 

// perform surgery 

} 

void makelncision() { 

// make incision (yikes!) 









I inherited my 
procedures so I didiVt 
bother with medical school. 
Relax, this woiVt hurt a bit. 
(now where did I put that 
power saw...) 



superclass 


Overrides the inherited 
treatPatient() method 

Adds one new method 


subclasses 



om mstahce variable 
om method 


Surgeon 


FamilyDoctor 

treatPatient () 

makelncisionQ 


makesHouseCalls 


giveAdvice () 


Adds one new 
instance variable 

Adds one new method 



How many instance variables does 
Surgeon have?_ 

How many instance variables does 
FamilyDoctor have?_ 

How many methods does Doctor have?— 

How many methods does Surgeon have? 

How many methods does FamilyDoctor 
have?_ 

Can a FamilyDoctor do treatPatient()? — 
Can a FamilyDoctor do makelncisionQ? _ 
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designing for inheritance 


Let's design the mheritance free for 
an Animal simulation program 

Imagine you’re asked to design a simulation program that 
lets the user throw a bunch of different animals into an 
environment to see what happens. We don’t have to code the 
thing now, we’re mostly interested in the design. 

We’ve been given a list of some of the animals that will be 
in the program, but not all. We know that each animal will 
be represented by an object, and that the objects will move 
around in the environment, doing whatever it is that each 
particular type is programmed to do. 

And we want other programmers to be able to add new 
kinds of animals to the program at any time. 

First we have to figure out the common, abstract 
characteristics that all animals have, and build those 
characteristics into a class that all animal classes can extend. 


O Look for objects that have common 
attributes and behaviors. 




What do these six types have in 
common? This helps you to abstract 
out behaviors, (step 2) 



How are these types related? This 
helps you to define the inheritance 
tree relationships (step 4-5) 
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Using inheritance to avoid 
duplicating code m subclasses 

We have five instance variables: 



picture - the file name representing the JPEG of this animal 

food - the type of food this animal eats. Right now, there 
can be only two values: meat or grass. 

hunger - an int representing the hunger level of the animal. 
It changes depending on when (and how much) the 
animal eats. 

boundaries - values representing the height and width of 
the ‘space’ (for example, 640 x 480) that the animals will 
roam around in. 


Design a class that represents 
the common state and behavior. 

These objects are all animals, so 
we'll make a common superclass 
called Animal. 

We*ll put in methods and instance 
variables that all animals might 
need. 


location - the X and Y coordinates for where the animal is 
in the space. 

We have four methods: 

makeNoise () - behavior for when the animal is supposed to 
make noise. 

eat() - behavior for when the animal encounters its 
preferred food source, meat or grass. 

sleep() - behavior for when the animal is considered asleep. 

roam() - behavior for when the animal is not eating or 
sleeping (probably just wandering around waiting to bump 
into a food source or a boundary). 


Animal 

picture 
food 
hunger 
boundaries 
location 

makeNoise() 
eat() 
sleep() 
roam() 



\\ 

Wolf 

S - 

Cat 
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designing for inheritance 


Po all animals cat the same way? 


Assume that we all agree on one thing: the instance 
variables will work for all Animal types. A lion will 
have his own value for picture, food (we’re thinking 
meat ), hunger, boundaries, and location. A hippo 
will have different values for his instance variables, 
but he’ll still have the same variables that the other 
Animal types have. Same with dog, tiger, and so on. 
But what about behavior} 


O Decide if a subclass 

needs behaviors (method 
implementations) that are specific 
to that particular subclass type. 


Which methods should we override? 

Does a lion make the same noise as a dog? Does 
a cat eat like a hippo? Maybe in 3 ; ⑽ r version，but 
in ours, eating and making noise are Animal-type- 
specific. We can’t figure out how to code those 
methods in such a way that they’d work for any 
animal. OK, that’s not true. We could write the 


Looking at the Animal class, 
we decide that eat() and 
makeNoise() should be overridden 
by the individual subclasses. 


makeNoise() method, for example, so that all it does 
is play a sound file defined in an instance variable 
for that type, but that’s not very specialized. Some 
animals might make different noises 
for different situations (like one 
for eating, and another when 
bumping into an enemy, etc.) 

So just as with the Amoeba 
overriding the Shape class rotate () 
method, to get more amoeba-specific (in 
other words, unique) behavior, we’ll have 
to do the same for our Animal subclasses. 


Animal 

picture 
food 
hunger 
boundaries 
location 



makeNoise() 

eat() 


sleep() 

roam() 


In the dog 

community, barking is an 
important part of our cultural 
identity. We have a unique sound, 
and we want that diversity to 
be recognized and respected. 





.o«se. f o, ^ .-t looks l»ke siee ? 
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inheritance and polymorphism 


Looking for more inheritance 
opportunities 

The class hierarchy is starting to shape up. We 
have each subclass override the makeNoise() and 
eat() methods, so that there’s no mistaking a Dog 
bark from a Cat meow (quite insulting to both 
parties). And a Hippo won’t eat like a Lion. 

But perhaps there’s more we can do. We have to 
look at the subclasses of Animal, and see if two 
or more can be grouped together in some way, 
and given code that’s common to only that new 
group. Wolf and Dog have similarities. So do 
Lion, Tiger, and Cat. 


o 

Look for more opportunities to use 
abstraction, by finding two or more 
subclasses that might need common 
behavior. 

We look at our classes and see 
that Wolf and Dog might have some 
behavior in common, and the same goes 
for Lion, Tiger, and Cat. 




e u o 於， 


Animal 

picture 
food 
hunger 
boundaries 
location 


makeNoise() 

eat() 


sleep() 

roam() 
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designing for inheritance 

o Finish the class hierarchy 
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inheritance and polymorphism 


Which method is called? 


The Wolf class has four methods. One 
inherited from Animal，one inherited from 
Canine (which is actually an overridden 
version of a method in class Animal), and 
two overridden in the Wolf class. When 
you create a Wolf object and assign it to 
a variable, you can use the dot operator 
on that reference variable to invoke all 
four methods. But which version of those 
methods gets called? 


make a iVol-f objcd*t 


dal Is version Wo\^ 


ddlls version m 


dal Is *thc version m Wo\^ 


dal Is version ir\ 


Wolf w = new Wolf() 


w.makeNoise (); 


w.roam(); 


w.eat (); 


w.sleep (); 


When you call a method on an object 
reference, you’re calling the most specific 
version of the method for that object type. 

In other words, the lowest one wins! 

“Lowest” meaning lowest on the 
inheritance tree. Canine is lower than 
Animal, and Wolf is lower than Canine, 
so invoking a method on a reference 
to a Wolf object means the JVM starts 
looking first in the Wolf class. If the JVM 
doesn’t find a version of the method in 
the Wolf class, it starts walking back up 
the inheritance hierarchy until it finds a 
match. 



Animal 


makeNoise() 

eat() 

sleep() 

roam() 




Canine 

roam() 
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practice designing an inheritance tree 


Resigning m Inheritance tree 


Class 

Superclasses 

Subclasses 

Clothing 


Boxers, Shirt 

Boxers 

Clothing 


Shirt 

Clolhing 



Inheritance Table 


superclass 

tiMore abstract) 



Clothing 


subclasses 
(wore specific) 



/\ 

Boxers Shirt 



[nlieritance Class Diagram 


Sharpen your pencil 


Draw an inheritance diagram here. 


Find the relationships that make sense. Fill in the last two columns 


Class 

Superclasses 

Subclasses 

Musician 



Rock Star 



Fan 



Bass Player 



Concert Pianist 







Hint: not everything can be connected to something else. 
Hint: you're allowed to add to or change the classes listed. 


Dumb Questions 


You said that the JVM starts 
walking up the inheritance tree, 
starting at the class type you invoked 
the method on (like the Wolf example 
on the previous page). But what 
happens if the JVM doesn’t ever find 
a match? 


A. 

厂 Y- Good question! But you don’t 
have to worry about that.The compiler 
guarantees that a particular method 
is callable for a specific reference type, 
but it doesn’t say (or care) from which 
class that method actually comes from 
at runtime. With the Wolf example, the 
compiler checks for a sleepO method, 
but doesn’t care that sleepO is actually 
defined in (and inherited from) class 
Animal. Remember that if a class 
inherits a method, it has the method. 


Where the inherited method is defined 
(in other words, in which superclass 
it is defined) makes no difference to 
the compiler. But at runtime, the JVM 

will always pick the right one. And 

the right one means, the most specific 
version for that particular object 
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inheritance and polymorphism 


Usiwg IS - A awd HAS - A 

Remember that when one class 
inherits from another, we say that the 
subclass extends the superclass. When 
you want to know if one thing should 
extend another, apply the IS-A test. 

Triangle IS-A Shape, yeah, that works. 

Cat IS-A Feline, that works too. 

Surgeon IS-A Doctor, still good. 

Tub extends Bathroom, sounds 
reasonable. 

Until you apply the IS-A test. 

To know if you’ve designed your types 
correctly, ask, “Does it make sense to 
say type X IS-A type Y?” If it doesn’t ， 
you know there’s something wrong 
with the design, so if we apply the IS-A 
test, Tub IS-A Bathroom is definitely 
false. 

What if we reverse it to Bathroom 
extends Tub? That still doesn’t work, 
Bathroom IS-A Tub doesn’t work. 

Tub and Bathroom are related, but 
not through inheritance. Tub and 
Bathroom are joined by a HAS-A 
relationship. Does it make sense to 
say “Bathroom HAS-A Tub ”？ If yes, 
then it means that Bathroom has a 
Tub instance variable. In other words, 
Bathroom has a reference to a Tub, but 
Bathroom does not extend Tub and 
vice-versa. 


Tub 

int size; 

Bathroom~l Bubbles b; I 

Tub bathtub;~~ Bubbles 1 

SinktheSink; I - 1 int radius 

int colorAmt; 


Bathroom HAS-A Tub and Tub HAS-A Bubbles. 
But nobody inherits from (extends) anybody else. 
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exploiting the power of objects 


莰 ut wait! There's more! 

The IS-A test works anywhere in the inheritance tree. If your 
inheritance tree is well-designed, the IS-A test should make 
sense when you ask any subclass if it IS-A any of its supertypes. 


If class B extends class A, class B IS-A class A. 

This is true anywhere in the inheritance tree. If 
class C extends class B，class C passes the IS-A 
test for both B and A. 


Canine extends Animal 
Wolf extends Canine 
Wolf extends Animal 

Canine IS-A Animal 
Wolf IS-A Canine 
Wolf IS-A Animal 




With an inheritance tree like the 
one shown here, you’re always 
allowed to say “Wolf extends 
Animal” or “Wolf IS-A Animal”. 

It makes no difference if Animal 
is the superclass of the superclass 
of Wolf. In fact, as long as Animal 
is somewhere in the inheritance 
hierarchy above Wolf, Wolf IS-A 
Animal will always be true. 

The structure of the Animal 
inheritance tree says to the world: 

“Wolf IS-A Canine, so Wolf can do 
anything a Canine can do. And 
Wolf IS-A Animal, so Wolf can do 
anything an Animal can do.” 

It makes no difference if Wolf 
overrides some of the methods 
in Animal or Canine. As far as 
the world (of other code) is 
concerned, a Wolf can do those 
four methods. How he does them, 
or in which class they’re overridden 
makes no difference. A Wolf can 
makeNoise(), eat(), sleep(), and 
roam() because a Wolf extends 
from class Animal. 
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inheritance and polymorphism 


How do you kwow if youVe gol 
your iwheritawce right? 

There’s obviously more to it than what we’ve 
covered so far, but we’ll look at a lot more OO 
issues in the next chapter (where we eventually 
refine and improve on some of the design work 
we did in this chapter). 

For now, though, a good guideline is to use the 
IS-A test. If “X IS-A Y’ makes sense, both classes 
(X and Y) should probably live in the same 
inheritance hierarchy. Chances are, they have 
the same or overlapping behaviors. 

Keep in mind that the 
inheritance IS-A relationship 
works in only one direction! 

Triangle IS-A Shape makes sense, so you can 
have Triangle extend Shape. 

But the reverse — Shape IS-A Triangle — does 
not make sense, so Shape should not extend 
Triangle. Remember that the IS-A relationship 
implies that if X IS-A Y, then X can do anything 
a Ycan do (and possibly more). 




Java 

Pass 

，>七0 0 
於油 0 



一一，二二二峽一 eer . 

b 一， 二 。一 -r 二二、 f 


X exten 


ds 乂乂 l! 



Sharpen your pencil 


Put a check next to the relationships that 
make sense. 

D Oven extends Kitchen 

□ Guitar extends Instrument 

□ Person extends Employee 
D Ferrari extends Engine 
D FriedEgg extends Food 

□ Beagle extends Pet 

□ Container extends Jar 
D Metal extends Titanium 

G GratefulDead extends Band 
Q Blonde extends Smart 
D Beverage extends Martini 


Hint: apply the IS-A test 
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who inherits what 


^^tJiereiqrejiP 

Dumb Questions 

So we see how a subclass gets 
to inherit a superclass method, but 
what if the superclass wants to use 
the subclass version of the method? 

A superclass won’t necessarily 
know about any of its subclasses. 

You might write a class and much 
later someone else comes along and 
extends it. But even if the superclass 
creator does know about (and wants 
to use) a subclass version of a method, 
there’s no sort of reverse or backwards 
inheritance.Think about it, children 
inherit from parents, not the other way 
around. 


In a subclass, what if I want to 
use BOTH the superclass version and 
my overriding subclass version of a 
method? In other words, I don’t want 
to completely replace the superclass 
version, I just want to add more stuff 
to it. 

^\^lYou can do this! And it's an 
important design feature.Think of the 
word "extends" as meaning,"I want 
to extend the functionality of the 
superclass ’： 

public void roam() { 
super.roam(); 

// my own roam stuff 

} 


You can design your superclass 
methods in such a way that they 
contain method implementations 
that will work for any subclass, even 
though the subclasses may still need 
to 'append' more code. In your subclass 
overriding method, you can call the 
superclass version using the keyword 
super. It’s like saying,"first go run the 
superclass version, then come back and 
finish with my own code...” 

tW,s dalls ⑽ d 

roa JUb to do 

your ovm subdlass-s^cd.V.t todt 



Who gets the Porsche, who gets the porcelain? 
(how to khow what a subclass can 
mherit from its superclass) 

A subclass inherits members of the 
superclass. Members include instance 
variables and methods, although later in 
this book we’ll look at other inherited members. A 
superclass can choose whether or not it wants a 
subclass to inherit a particular member by the level of 
access the particular member is given. 

There are four access levels that we’ll cover in this book. 
Moving from most restrictive to least, the four access 
levels are: 


private default protected public 
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Access levels control who sees what, and are crucial 
to having well-designed, robust Java code. For now we’ll 
focus just on public and private. The rules are simple for 
those two: 

public members are inherited 
private members are not inherited 

When a subclass inherits a member, it is as if the 
subclass defined the member itself. In the Shape 
example, Square inherited the rotate () and 
playSound () methods and to the outside world (other 
code) the Square class simply has a rotate () and 
playSound () method. 

The members of a class include the variables and 
methods defined in the class plus anything inherited 
from a superclass. 

Note: gc 七 move details about dc-faul-t pvo 七 cd 七 cd in dKaptcv- 

I 石 (deployment) and appendix B- 






inheritance and polymorphism 


Whew desighihg with inheritance, 
are you USIHQ or abusing? 

Although some of the reasons behind these rules won’t be 
revealed until later in this book, for now, simply knowing a 
few rules will help you build a better inheritance design. 


DO use inheritance when one class is a more specific type 
of a superclass. Example: Willow is a more specific type of 
Tree, so Willow extends Tree makes sense. 


DO consider inheritance when you have behavior 
(implemented code) that should be shared among 
multiple classes of the same general type. Example: 

Square, Circle, and Triangle all need to rotate and play 
sound, so putting that functionality in a superclass Shape 
might make sense, and makes for easier maintenance and 
extensibility. Be aware, however, that while inheritance is 
one of the key features of object-oriented programming, 
it’s not necessarily the best way to achieve behavior reuse. 
It’ll get you started, and often it’s the right design choice, 
but design patterns will help you see other more subtle 
and flexible options. If you don’t know about design 
patterns, a good follow-on to this book would be Head First 
Design Patterns. 


DO NOT use inheritance just so that you can reuse 
code from another class, if the relationship between the 
superclass and subclass violate either of the above two 
rules. For example, imagine you wrote special printing 
code in the Alarm class and now you need printing code 
in the Piano class, so you have Piano extend Alarm so that 
Piano inherits the printing code. That makes no sense! A 
Piano is not a more specific type of Alarm. (So the printing 
code should be in a Printer class, that all printable objects 
can take advantage of via a HAS-A relationship.) 


DO NOT use inheritance if the subclass and superclass 
do not pass the IS-A test. Always ask yourself if the subclass 
IS-A more specific type of the superclass. Example: Tea IS- 
A Beverage makes sense. Beverage IS-A Tea does not. 


BULLET POINTS - 

■ A subclass extends a superclass. 

■ A subclass inherits all public instance 
variables and methods of the superclass, but 
does not inherit the private instance variables 
and methods of the superclass. 

■ Inherited methods can be overridden; instance 
variables cannot be overridden (although they 
can be redefined in the subclass, but that’s 
not the same thing, and there’s almost never a 
need to do it.) 

■ Use the IS-A test to verify that your 
inheritance hierarchy is valid. If X extends Y, 
then X IS-AY must make sense. 

■ The IS-A relationship works in only one 
direction. A Hippo is an Animal, but not all 
Animals are Hippos. 

■ When a method is overridden in a subclass, 
and that method is invoked on an instance of 
the subclass, the overridden version of the 
method is called. (The lowest one wins.) 

■ If class B extends A, and C extends B, class 
B IS-A class A, and class C IS-A class B, and 
class C also IS-A class A. 
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exploiting the power of objects 

So what does all this 
inheritance really buy you? 


You get a lot of OO mileage by designing 
with inheritance. You can get rid of duplicate 
code by abstracting out the behavior common 
to a group of classes, and sticking that code 
in a superclass. That way, when you need to 
modify it, you have only one place to update, 
and the change is magically reflected in all the 
classes that inherit that behavior. Well, there’s 
no magic involved, but it is pretty simple: 
make the change and compile the class 
again. That’s it. You don’t have to touch the 
subclasses! 

Just deliver the newly-changed superclass, and 
all classes that extend it will automatically use 
the new version. 

A Java program is nothing but a pile of classes, 
so the subclasses don’t have to be recompiled 
in order to use the new version of the 
superclass. As long as the superclass doesn’t 
break anything for the subclass, everything’s 
fine. (We’ll discuss what the word ‘break’ 
means in this context, later in the book. For 
now, think of it as modifying something in 
the superclass that the subclass is depending 
on, like a particular method’s arguments or 
return type, or method name, etc.) 


① You avoid duplicate 
code. 

Put common code in one place, and let 
the subclasses inherit that code from a 
superclass. When you want to change that 
behavior, you have to modify it in only 
one place, and everybody else (i.e. all the 
subclasses) see the change. 

② You define a common 
protocol for a group of 
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inheritance and polymorphism 


Inheritance lets you guarantee that 
all classes grouped under a certain 
supertype have all the methods that 
the supertype has* 

lw other words, you define a common protocol for a 
set of classes related through inheritance. 

When you define methods in a superclass, that can be 
inherited by subclasses, you’re announcing a kind of 
protocol to other code that says, “All my subtypes (i.e. 
subclasses) can do these things, with these methods 
that look like this...” 

In other words, you establish a contract. 

Class Animal establishes a common protocol for all 
Animal subtypes: 


And I care because... 

Because you get to take advantage of 
polymorphism. 

Which matters to me 
because... 

Because you get to refer to a subclass 
object using a reference declared as the 
supertype. 


Animal 


makeNoise() 

eat() 

sleep() 

roam() 


TV,at eludes -etW 
巧 L 士 W 士 


And remember, when we say any Animal, we mean 
Animal and any class that extends from Animal Which 
again means, any class that has Animal somewhere above it 
in the inheritance hierarchy. 

But we’re not even at the really cool part yet, because 
we saved the best — polymorphism — for last. 

When you define a supertype for a group of classes, 
any subclass of that supertype can be substituted where the 
supertype is expected. 

Say, what? 

Don’t worry, we’re nowhere near done explaining it. 
Two pages from now, you’ll be an expert. 


And that means to me... 

You get to write really flexible code. 
Code that’s cleaner (more efficient, 
simpler). Code that’s not just easier to 
develop, but also much, much easier to 
extend, in ways you never imagined at 
the time you originally wrote your code. 

That means you can take that tropical 
vacation while your co-workers update 
the program, and your co-workers might 
not even need your source code. 

You’ll see how it works on the next page. 

We don’t know about you, but 
personally, we find the whole 
tropical vacation thing 
particularly motivating. 



★When we say “all the methods” we mean “all the inheritable methods”, which 
for now actually means, “all the public methods”, although later we'll refine that 
definition a bit more. 
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the way polymorphism works 


The 3 steps of object 
declaration and assignment 


To see how polymorphism 
works, we have to step back 
and look at the way we 
normally declare a reference 
and create an object... 



Dog myDog 


2 

3 

=new Dog(); 


O Declare a reference 
variable 


Dog myDog = new Dog ()； 

Tells the JVM to allocate space for a 
reference variable.The reference variable 
is,forever, of type Dog. In other words, 
a remote control that has buttons to 
control a Dog, but not a Cat or a Button 
or a Socket. 



❺ Create an object 

Dog myDog = new Dog (); 

Tells the JVM to allocate space for 
a new Dog object on the garbage 
collectible heap. 

Dog object 



❺ 


Link the object 
and the reference 


Dog myDog = new Dog(); 

Assigns the new Dog to the refer¬ 
ence variable myDog. In other words, 

program the remote control. 




Dog object 


myDog' 
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inheritance and polymorphism 


The important point is that the 
reference type AND the object 
type are the same. 


In this example, both are Dog. 



Dog 


\ 



These *two are -the sa^e -type. The 

variable -type is as Pog, ar\d -the objed-t 

is d\rca*tcd as PogO. 


But with polymorphism, the 
reference and the object can 
be different. 


Animal myDog = new Dog(); 



Animal 


\ 



These -two are htOT -the sa^e -type. The 
reference variable -type is Atc\^ctA as 
bu*t {he object is dvca*tcd as r\cw P03O. 


you are here ► 


185 






polymorphism in action 


With polymorphism, the reference 
type can be a superclass of the 
actual object type. 

When you declare a reference variable, 
any object that passes the IS-A test for the 
declared type of the reference variable 
can be assigned to that reference. In 
other words, anything that extends the 
declared reference variable type can 
be assigned to the reference 
variable. This lets you do 
things like make polymorphic 
arrays. 






OK, OK maybe an example will help. 




>uovd s > 


Animal [ ] animals = new Animal [5]; 


animals [0] = new Dog(); 
animals [1] = new Cat(); 
animals [2] = new Wolf(); 
animals [3] = new Hippo(); 
animals [4] = new Lion(); 


〆 



for (int i = 0; i < animals.length; i++) 


Bu-t look Y 七七 0 d 。 … Y ou 刪 

subclass o( A 灼 i 你 al m A 灼 i 州 al arvayf 




^9/ 


animals[i].eat(); 


animals[i].roam(); 




W\)cy\ K \ is O, a P05 is at 0 m {ht a^rv-ay, so 
you Po^s ea 七 0 mctiiod. K \ is I, you 

Cat's catO 
Sdmc V-oamO. 
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inheritance and polymorphism 


But wait! There’s more! 


You can have polymorphic 
arguments and return types. 

If you can declare a reference variable 
of a supertype, say, Animal, and assign a 
subclass object to it, say, Dog, think of how 
that might work when the reference is an 
argument to a method... 




class Vet 


public void giveShot(Animal a: 


// do horrible things to the Animal at 
// the other end of the 'a' parameter 
a.makeNoise(); 





Ahil^yp* aHr e ^ e,r tar, ^ ke 

,s ^Hy oui i^ c i^ hd L W U 
whose — 以二 lZ^ i，s 


class PetOwner { 

public void start() { 

Vet v = new Vet(); 
Dog d = new Dog(); 


/Wal, 



Hippo h = new Hippo(); 
v • giveShot (d); ^ ^akcNo.scO 


v.giveShot(h); 


Wippo’s wkcU) 


<ruhs 
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exploiting the power of polymorphism 


O 


0 


NOW I get it! If I write 
my code using polymorphic arguments, 
where I declare the method parameter as a 
superclass type, I can pass in any subclass object at 
runtime. Cool. Because that also means I can write my 
code, go on vacation, and someone else can add new 
subclass types to the program and my methods will 
still work... (the only downside is I’m just making life 
easier for that idiot Jim). 




With polymorphism, you caw write code that doesn't 
have to change when you introduce new subclass 
types into the program. 


Remember that Vet class? If you write that Vet class using 
arguments declared as type Animal, your code can handle any 
Animal subclass. That means if others want to take advantage of 
your Vet class, all they have to do is make sure their new Animal 
types extend class Animal. The Vet methods will still work, even 
though the Vet class was written without any knowledge of the 
new Animal subtypes the Vet will be working on. 


Why is polymorphism guaranteed to work this way? Why is 
it always safe to assume that any subclass type will have the 
methods you think you’re calling on the superclass type (the 
superclass reference type you’re using the dot operator on)? 
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fJierei£irejiP 

Dumb Questions 

Are there any practical limits 
on the levels of subclassing? How 
deep can you go? 

If you look in the Java API, 
you’ll see that most inheritance 
hierarchies are wide but not deep. 
Most are no more than one or two 
levels deep, although there are 
exceptions (especially in the GUI 
classes). You’ll come to realize that 
it usually makes more sense to keep 
your inheritance trees shallow, but 
there isn’t a hard limit (well, not one 
that you’d ever run into). 

Hey , 丨 just thought of 
something... if you don’t have 
access to the source code for a class, 
but you want to change the way a 
method of that class works, could 
you use subclassing to do that? To 
extend the "bad” class and override 
the method with your own better 
code? 

Yep.That’s one cool feature 
of 00, and sometimes it saves you 
from having to rewrite the class 
from scratch, or track down the 
programmer who hid the source code. 


Can you extend any class? Or 
is it like class members where if the 
class is private you can’t inherit it... 

There’s no such thing as a 
private class, except in a very special 
case called an /'nner class, that we 
haven’t looked at yet. But there are 
three things that can prevent a class 
from being subclassed. 

The first is access control. Even though 
a class can't be marked private, a 
class can be non-public (what you 
get if you don’t declare the class as 
public). A non-public class can be 
subclassed only by classes in the 
same package as the class. Classes in 
a different package won’t be able to 
subclass (or even use, for that matter) 
the non-public class. 

The second thing that stops a class 
from being subclassed is the keyword 
modifier final. A final class means 
that it’s the end of the inheritance 
line. Nobody, ever, can extend a final 
class. 

The third issue is that if a class has 
only private constructors (we’ll 
look at constructors in chapter 9), it 
can’t be subclassed. 


Why would you ever want to 
make a final class? What advantage 
would there be in preventing a class 
from being subclassed? 

Typically,you won’t make your 
classes final. But if you need security 
— the security of knowing that the 
methods will always work the way 
that you wrote them (because they 
can’t be overridden), a final class 
will give you that. A lot of classes in 
the Java API are final for that reason. 
The String class, for example, is final 
because, well, imagine the havoc if 
somebody came along and changed 
the way Strings behave! 

Can you make a method final, 
without making the whole class 
final? 

If you want to protect a specific 
method from being overridden, mark 
the method with the finalmodifier. 
Mark the whole class as final if you 
want to guarantee that none of the 
methods in that class will ever be 
overridden. 
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overriding methods 


Keeping the contract: rules for overriding 


When you override a method from a superclass, you’re agreeing to 
fulfill the contract. The contract that says, for example, “I take no 
arguments and I return a boolean.” In other words, the arguments 
and return types of your overriding method must look to the outside 
world exactly like the overridden method in the superclass. 

The methods are the contract. 

If polymorphism is going to work, the Toaster’s version of the 
overridden method from Appliance has to work at runtime. 
Remember, the compiler looks at the reference type to decide 
whether you can call a particular method on that reference. With 
an Appliance reference to a Toaster, the compiler cares only if class 
Appliance has the method you’re invoking on an Appliance reference. 
But at runtime, the JVM looks not at the reference type (Appliance) but 
at the actual Toaster object on the heap. So if the compiler has already 
approved the method call, the only way it can work is if the overriding 
method has the same arguments and return types. Otherwise, 
someone with an Appliance reference will call turnOn () as a no- 
arg method, even though there’s a version in Toaster that takes an 
int. Which one is called at runtime? The one in Appliance. In other 
words, the turnOn (int level) method in Toaster is not an override! 

① Arguments must be the same, and return 
types must be compatible. 


Appliance 


boolean turnOn() 
boolean turnOff() 




Toaster 


TWs 





The contract of superclass defines how other code can use a method. 
Whatever the superclass takes as an argument, the subclass over¬ 
riding the method must use that same argument. And whatever the 
superclass declares as a return type, the overriding method must de¬ 
clare either the same type, or a subclass type. Remember, a subclass 
object is guaranteed to be able to do anything its superclass declares, 
so it’s safe to return a subclass where the superclass is expected. 


② The method can’t be less accessible. 


Appliance 


public boolean turnOn() 
public boolean turnOnQ 


That means the access level must be the same, or friendlier. That 
means you can’t, for example, override a public method and make 
it private. What a shock that would be to the code invoking what it 
thinks (at compile time) is a public method, if suddenly at runtime 
the JVM slammed the door shut because the overriding version 
called at runtime is private! 

So far we’ve learned about two access levels: private and public. 
The other two are in the deployment chapter (Release your Code) 
and appendix B. There’s also another rule about overriding related 
to exception handling, but we’ll wait until the chapter on exceptions 
(Risky Behavior) to cover that. 


hot 

一 e 




Toaster 
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inheritance and polymorphism 


Overloading a method 

Method overloading is nothing more than having 
two methods with the same name but different 
argument lists. Period. There’s no polymorphism 
involved with overloaded methods! 

Overloading lets you make multiple versions 
of a method, with different argument lists, for 
convenience to the callers. For example, if you 
have a method that takes only an int, the calling 
code has to convert, say, a double into an int 
before calling your method. But if you overloaded 
the method with another version that takes a 
double, then you’ve made things easier for the 
caller. You’ll see more of this when we look into 
constructors in the object lifecycle chapter. 

Since an overloading method isn’t trying to 
fulfill the polymorphism contract defined by its 
superclass, overloaded methods have much more 
flexibility. 

① The return types can be 
different. 

You’re free to change the return types in 
overloaded methods, as long as the argument lists 
are different. 

② You can’t change ONLY the 
return type. 

If only the return type is different, it’s not a 
valid overload — the compiler will assume 
you’re trying to override the method. And even 
that won't be legal unless the return type is 
a subtype of the return type declared in the 
superclass. To overload a method, you MUST 
change the argument list, although you can 
change the return type to anything. 

③ You can vary the access 
levels in any direction. 

You’re free to overload a method with a method 
that’s more restrictive. It doesn’t matter, since the 
new method isn’t obligated to fulfill the contract of 
the overloaded method. 


An overloaded mediodis 
just a different method lhat 

li 卿 ens to have Ae same 
mediod nme. It has nodiing 
to do wiA inheritance and 
polymorpliisin. An overloaded 
mediodis NOT Ae sme as 

an overridden method. 


Legal examples of method 
overloading: 

public class Overloads { 

String uniquelD; 

public int addNums (int a, int b) { 

return a + b; 

} 

public double addNums (double a, double b) { 

return a + b; 

} 

public void setUniquelD (String theID) { 

// lots of validation code, and then : 
uniquelD = thelD; 

} 

public void setUniquelD (int ssNumber) { 
String numString = + ssNumber; 

setUniquelD(numString); 
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exercise: Mixed Messages 



the program: 


Mixed 

MeSsagGS 

a = 6 56 

b = 5; 11 

a = 5; 65 


A short Java program is listed below. One block of 
the program is missing! Your challenge is to match 
the candidate block of code (on the left), with the 
output that you’d see if the block were inserted. 

Not all the lines of output will be used, and some of 
the lines of output might be used more than once. 
Draw lines connecting the candidate blocks of 
code with their matching command-line output. 


class A { 

int ivar = 7; 
void ml() { 

System.out.print(A"s ml,"); 

} 

void m2() { 

System.out.print(A f s m2,"); 

} 

void m3() { 

System.out.print(A f s m3,"); 


class B extends A { 
void ml() { 

System.out.print( yy B A s ml,"); 


class C extends B { 
void m3() { 

System, out. print ( /y C" s m3, n + (ivar + 6)); 


public class Mixed2 { 

public static void main(String [] args) { 
A a = new A(); 

B b = new B(); 

C c = new C(); 

A a2 = new C() ; candidate code 

- ^ goes here 

(three lines) 


code 

candidates: 


b. ml(); ^ 

c. m2(); L 

a.m3( ); J 


c.ml (); 飞 
c.m2(); V 

c. m3 ( ); J 


a. ml (); 飞 

b. m2(); > 

c. m3 ( ); J 


a2 .ml () 
a2 .m2 () 
a2 .m3 () 



output: 


A r S 

ml r 

A r s 

m2 r 

C's 

m3 , 

6 

B^S 

ml r 

A r s 

m2 r 

A r s 

m3 , 


A r S 

ml r 

B r s 

m2 r 

A r s 

m3 , 


B r S 

ml r 

A r s 

m2 r 

C r s 

m3 , 

13 

B r S 

ml r 

C r s 

m2 r 

A r s 

m3 , 


B r S 

ml r 

A r s 

m2 r 

C r s 

m3 , 

6 

A r S 

ml r 

A r s 

m2 r 

C r s 

m3 , 

13 


192 chapter 7 











inheritance and polymorphism 



f - BE Compiler 

， ' 痛 eh of lie A - B pair 


A^cli of {ke A - B pairs of mediods listed on the ri^ht, if 
inserted into the classes on the left, would compile and 
produce the output shown? (The A inediod inserted into 
class Monster, the B ttiediod inserted into class Vampire.) 


public class MonsterTestDrive { 

public static void main(String [] args) { 
Monster [] ma = new Monster[3]; 
ma[0] = new Vampire(); 
ma[1] = new Dragon(); 


ma[2] = new Monster(); 
for(int x = 0; x < 3; x++) { 
ma[x].frighten(x); 


class Monster { 

o 


1 

O 


O 


boolean frighten(int d) { 

System.out.println("arrrgh"); 
return true; 


boolean frighten(int x) { 

System, out .println ( yy a bite?"); 
return false; 


2 

o 


o 


boolean frighten(int x) { 

System.out.println("arrrgh"); 
return true; 


int frighten(int f) { 

System, out .println ( Ji a bite ?’’）； 
return 1; 


class Vampire extends Monster { 

@ 

} 

class Dragon extends Monster { 
boolean frighten(int degree) { 

System, out. println ( "breath fire ”）； 
return true; 

} __ 

I File Edit Window Help SaveYourself 


% java MonsterTestDrive 
a bite? 
breath fire 
arrrgh 



boolean frighten(int x) { 

System.out.println("arrrgh"); 
return false; 


o 


boolean scare(int x) { 

System, out .println ( iy a bite ?”）； 
return true; 


4 

o 


boolean frighten(int z) { 

System.out.println("arrrgh ”）； 
return true; 


o 


boolean frighten(byte b) { 

System, out .println ( 11 a. bite?"); 
return true; 
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puzzle: Pool Puzzle 




Pool Puzzle 


Your job is to take code snippets from the pool and place them into 
the blank lines in the code. You may use the same snippet more 
than once, and you might not need to use all the snippets. Your 
goal is to make a set of classes that will compile and run together 
as a program. Don’t be fooled - this one’s harder than it looks. 


public class Rowboat 
public _ 


rowTheBoat() { 


System. out. print ( yy stroke natasha ”）； 


public class 


private int 
void 


length = len; 


public int getLength() { 


public 


move() { 


System.out.print( 


public class TestBoats { 


main(String[] args){ 


_ bl = new Boat(); 

Sailboat b2 = new _(); 


Rowboat 


new Rowboat(); 


b2•setLength(32); 

bl._ ()； 

b3._ ()； 

_•move(); 


public class 
public _ 


O { 


System.out.print( 


Boat { 


)； 


OUTPUT: 


drift drift hoist sail 
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code 

candidates: 

Mixed 

MeSsagGS 


a.2 .ml (); 
a2.m2 (); 
a2.m3 (); 



A"s ml. A"s m2, C's m3. 


6 

13 

6 

13 




inheritance and polymorphism 


BE 如 Compiler 


Set 1 will work. 



Exercise 

Solutions 



Set 2 will not compile because of Vampire’s return 
type (int). 

The Vampire’s frighten() method (B) is not a legal 
override OR overload of Monster’s frighten() method. 
Changing ONLY the return type is not enough 
to make a valid overload, and since an int is not 
compatible with a boolean, the method is not a valid 
override. (Remember, if you change ONLY the return 
type, it must be to a return type that is compatible 
with the superclass version’s return type, and then it’s 
an override. 

Sets 3 and 4 will compile, but produce: 

arrrgh 

breath fire 

arrrgh 

Remember, class Vampire did not override class 
Monster’s frighten() method. (The frighten() method 
in Vampire’s set 4 takes a byte, not an int.) 
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puzzle answers 



public class Rowboat extends Boat { 
public void rowTheBoat() { 

System.out.print("stroke natasha^); 

> 

> 

public class Boat { 
private int length ; 
public void setLength ( int len ) { 
length = len; 

> 

public int getLength() { 

return length ； 

> 

public void move() { 

System.out.print( "drift "); 


public class TestBoats { 

public Static void main ( String [ ] args ) { 
Boat bl = new Boat(); 

Sailboat b2 = new Sailboat(); 
Rowboat b3 =new Rowboat(); 
b2.setLength(32); 

bi .move ()； 
b3 .move ()； 
b2 .move(); 


public class Sailboat extends Boat { 
public void move () { 

System.out.print( hoist Sail "); 


OUTPUT: 


drift drift hoist sail 
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8 interfaces and abstract classes 


Serious Polymorphism 



Inheritance is just the beginning. To exploit polymorphism, we need interfaces 
(and not the GUI kind). We need to go beyond simple inheritance to a level of flexibility and 
extensibility you can get only by designing and coding to interface specifications. Some of the 
coolest parts of Java wouldn’t even be possible without interfaces, so even if you don’t design 
with them yourself, you still have to use them. But you'll want to design with them. You'll need 
to design with them. Youll wonder how you ever lived without them. What's an interface? It’s 
a 1 00% abstract class. What’s an abstract class? It’s a class that can’t be instantiated. What’s that 
good for? You’ll see in just a few moments. But if you think about the end of the last chapter, 
and how we used polymorphic arguments so that a single Vet method could take Animal 
subclasses of all types, well, that was just scratching the surface. Interfaces are the poly in 
polymorphism.The ab in abstract.The caffeine in Java. 
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designing with inheritance 


l?id we forget about something 
whew we designed this? 

The class structure isn’t too bad. We’ve designed 
it so that duplicate code is kept to a minimum, 
and we’ve overridden the methods that we think 
should have subclass-specific implementations. 
We’ve made it nice and flexible from a 
polymorphic perspective, because we can design 
Animal-using programs with Animal arguments 
(and array declarations), so that any Animal 
subtype — including those we never imagined at the 
time we wrote our code — can be passed in and used 
at runtime. We’ve put the common protocol for 
all Animals (the four methods that we want the 
world to know all Animals have) in the Animal 
superclass, and we’re ready to start making new 
Lions and Tigers and Hippos. 


Tiger 


makeNoise() 

eat() 


Animal 

picture 
food 
hunger 
boundaries 
location 


makeNoise() 

eat() 


sleep() 

roam() 



makeNoise() 

eat() 




Wolf 


makeNoise() 

eat() 


makeNoise() 

eat() 



w 


垃 I 
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interfaces and polymorphism 


We know we can say: 

Wolf aWolf = new Wolf(); 



And we know we can say: 

Animal aHippo = new Hippo(); 



These two a\rc NOT same -type- 


But here’s where it gets weird: 


Animal anim = new Animal(); 


*to 

By\ /W ||rw al object 



Animal 


These *two av-c *thc same -type, but.. 

v/ha*t *thc does ^ ^Wi 州 al object look like? 
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when objects go bad 

What does a new Animal() object 
look like? 



scary objects 





What are the instance variable values? 

Some classes just should not be 
instantiated! 


It makes sense to create a Wolf object or a Hippo 
object or a Tiger object, but what exactly is an 
Animal object? What shape is it? What color, size, 
number of legs... 

Trying to create an object of type Animal is like a 
nightmare Star Trek™ transporter accident. The 

one where somewhere in the beam-me-up process 
something bad happened to the buffer. 

But how do we deal with this? We need an Animal 
class, for inheritance and polymorphism. But we 
want programmers to instantiate only the less 
abstract subclasses of class Animal, not Animal itself. 
We want Tiger objects and Lion objects, not Animal 
objects. 

Fortunately, there’s a simple way to prevent a class 
from ever being instantiated. In other words, to stop 
anyone from saying “new” on that type. By marking 
the class as abstract, the compiler will stop any 
code, anywhere, from ever creating an instance of 
that type. 


You can still use that abstract type as a reference type 
In fact,that’s a big part of why you have that abstract 
class in the first place (to use it as a polymorphic 
argument or return type, or to make a polymorphic 
array). 

When you’re designing your class inheritance 
structure, you have to decide which classes are 
abstract and which are concrete. Concrete classes are 
those that are specific enough to be instantiated. A 
concrete class just means that it’s OK to make objects 
of that type. 

Making a class abstract is easy — put the keyword 
abstract before the class declaration: 


abstract class Canine extends Animal { 
public void roam() { } 
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interfaces and polymorphism 


The compiler won't let you instantiate 
an abstract class 


An abstract class means that nobody can ever make a new 
instance of that class. You can still use that abstract class as a 
declared reference type, for the purpose of polymorphism, but 
you don’t have to worry about somebody making objects of that 
type. The compiler guarantees it. 

abstract public class Canine extends Animal 


public void roam() { } 


public class MakeCanine 

public void go () { -p^ |S 




• |S 0^) y 


Canine c; 
c = new Dog(); 
c = new Canine() 
c.roam(); 










y° u do ihis. 


I File Edit Window Help BeamMeUp ■ 


% javac MakeCanine.java 

MakeCanine.java : 5 : Canine is abstract; 
cannot be instantiated 
c = new Canine(); 

A 

1 error 


An abstract class has virtually* no use, no value, no 
purpose in life, unless it is extended. 

With an abstract class, the guys doing the work at runtime 
are instances of a subclass of your abstract class. 

•^TKcv-c is an to an abs-tv-adt dlass dan 

Kavc s 七 a 七 id members (see dKaptcv- 10 ). 
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abstract and concrete classes 


Abstract vs. Concrete 


abs*t\rad*t 


A class that’s not abstract is called 
a concrete class. In the Animal 
inheritance tree, if we make 
Animal, Canine, and Feline 
abstract, that leaves Hippo, Wolf, 
Dog, Tiger, Lion, and Cat as the 
concrete subclasses. 

Flip through the Java API and 
you’ll find a lot of abstract classes, 
especially in the GUI library. What 
does a GUI Component look 
like? The Component class is the 
superclass of GUI-related classes 
for things like buttons, text areas, 
scrollbars, dialog boxes, you name 
it. You don’t make an instance of 
a generic Component and put it on 
the screen, you make aJButton. In 
other words, you instantiate only a 
concrete subclass of Component, but 
never Component itself. 


Animal 






abstract or concrete? 

How do you know when a class should be 
abstract? Wine is probably abstract. But what 
about Red and White? Again probably abstract 
(for some of us, anyway). But at what point in the 
hierarchy do things become concrete? 

Do you make PinotNoir concrete, or is it abstract 
too? It looks like the Camelot Vineyards 1997 
Pinot Noir is probably concrete no matter what. 
But how do you know for sure? 

Look at the Animal inheritance tree above. Do the 
choices we’ve made for which classes are abstract 
and which are concrete seem appropriate? 

Would you change anything about the Animal 
inheritance tree (other than adding more Animals, 
of course)? 
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Abstract methods 


interfaces and polymorphism 


Besides classes, you can mark methods abstract, too. An abstract 
class means the class must be extended .，an abstract method means 
the method must be overridden. You might decide that some (or all) 
behaviors in an abstract class don’t make any sense unless they’re 
implemented by a more specific subclass. In other words, you can’t 
think of any generic method implementation that could possibly be 
useful for subclasses. What would a generic eat() method look like? 

An abstract method has no body! 

Because you’ve already decided there isn’t any code that would make 
sense in the abstract method, you won’t put in a method body. So no 
curly braces — just end the declaration with a semicolon. 


public abstract void eat(); 


Ko mctw W'f! 

UA ^ a scw 




If you declare an abstract method, you MUST 
mark the class abstract as well. You can’t have 
an abstract method in a non-abstract class. 

If you put even a single abstract method in a class, you have to 
make the class abstract. But you can mix both abstract and non¬ 
abstract methods in the abstract class. 



^Jierei^irejiP 

Dumb Questions 


I What is the point of an abstract method? I thought 
the whole point of an abstract class was to have common 
code that could be inherited by subclasses. 


Inheritable method implementations (in other words, 
methods with actual bodies) are A Good Thing to put in a 
superclass. When it makes sense. And in an abstract class, it 
often doesn’t make sense, because you can’t come up with 
any generic code that subclasses would find useful.The 
point of an abstract method is that even though you haven’t 
put in any actual method code, you’ve still defined part of 
the protocol for a group of subtypes (subclasses). 


Which is good because 


Polymorphism! Remember, what you want is the 
ability to use a superclass type (often abstract) as a method 
argument, return type, or array type.That way, you get to 
add new subtypes (like a new Animal subclass) to your 
program without having to rewrite (or add) new methods 
to deal with those new types. Imagine how you’d have to 
change the Vet class, if it didn’t use Animal as its argument 
type for methods. You’d have to have a separate method 
for every single Animal subclass! One that takes a Lion, one 
that takes a Wolf, one that takes a... you get the idea. So with 
an abstract method, you’re saying,"All subtypes of this type 
have THIS method.’’for the benefit of polymorphism. 
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you must implement abstract methods 


You MUST implement all abstract methods 



一 I have wonderful news, 
mother. Joe finally implemented 
all his abstract methods! Now 
everything is working just the 
(way we planned... ) 


Implementing an abstract 
method is just like 
overriding a method. 


Abstract methods don’t have a body; they exist solely for polymorphism. That 
means the first concrete class in the inheritance tree must implement all abstract 
methods. 

You can, however, pass the buck by being abstract yourself. If both Animal and 
Canine are abstract, for example, and both have abstract methods, class Canine 
does not have to implement the abstract methods from Animal. But as soon as we 
get to the first concrete subclass, like Dog, that subclass must implement alloi the 
abstract methods from both Animal and Canine. 

But remember that an abstract class can have both abstract and non-abstract 
methods, so Canine, for example, could implement an abstract method from 
Animal, so that Dog didn’t have to. But if Canine says nothing about the abstract 
methods from Animal, Dog has to implement all of Animal’s abstract methods. 

When we say “you must implement the abstract method”, that means you must 
provide a body. That means you must create a non-abstract method in your class 
with the same method signature (name and arguments) and a return type that is 
compatible with the declared return type of the abstract method. What you put in 
that method is up to you. All Java cares about is that the method is there, in your 
concrete subclass. 
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interfaces and polymorphism 


e^^rpen your pencil 


Abstract vs. Concrete Classes 

Let's put all this abstract rhetoric into some concrete use. In the middle 
column we’ve listed some classes. Your job is to imagine applications 
where the listed class might be concrete, and applications where the listed 
class might be abstract. We took a shot at the first few to get you going. 

For example, class Tree would be abstract in a tree nursery program, where 
differences between an Oak and an Aspen matter. But in a golf simulation 
program, Tree might be a concrete class (perhaps a subclass of Obstacle), 
because the program doesn’t care about or distinguish between different 
types of trees. (There’s no one right answer; it depends on your design.) 


Concrete 

golf course simulation 

satellite photo application 


Sample class 

Tree 

House 

Town 

Football Player 
Chair 

Customer 

Sales Order 

Book 

Store 
Supplier 
Golf Club 

Carburetor 

Oven 


Abstract 

tree nursery application 
architect application 

coaching application 
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polymorphism examples 

Polymorphism iw action 

Let’s say that we want to write our own kind of list class, one that will hold 
Dog objects, but pretend for a moment that we don’t know about the 
ArrayList class. For the first pass, we’ll give it just an add() method. We’ll use 
a simple Dog array (Dog []) to keep the added Dog objects, and give it a 
length of 5. When we reach the limit of 5 Dog objects, you can still call the 
add() method but it won’t do anything. If we’re not at the limit, the add() 
method puts the Dog in the array at the next available index position, then 
increments that next available index (nextlndex). 


Building our own Dog-specific list 

(Perhaps the world’s worst attempt at making our 
own ArrayList kind of class, from scratch.) 


MyDogList 


uugu uuyb 
int nextlndex 


duu^uuy u; 


public class MyDogList { Use a oW 

private Dog [] dogs = new Dog[5]; 

private int nextlndex = 0; < —— \MtW *tW»s 

七 iwe a mv/ Po— s added ， 


public void add(Dog d) { 

if (nextlndex < dogs.length) { 
dogs[nextlndex] = d; 


3yvdi 3 message- 


System. out. println (''Dog added at '' + nextlndex) 


nextlndex++ 


⑽ t 卜 
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interfaces and polymorphism 


Uh-oK now we need to keep Cats, too. 

We have a few options here: 

1) Make a separate class, MyCatList, to hold Cat objects. Pretty clunky. 

2) Make a single class, DogAndCatList, that keeps two different arrays as instance 
variables and has two different add() methods: addCat(Cat c) and addDog(Dog 
d) • Another clunky solution. 

3) Make heterogeneous AnimalList class, that takes any kind of Animal subclass 
(since we know that if the spec changed to add Cats, sooner or later we’ll have 
some other kind of animal added as well). We like this option best, so let’s change 
our class to make it more generic, to take Animals instead of just Dogs. We’ve 
highlighted the key changes (the logic is the same, of course, but the type has 
changed from Dog to Animal everywhere in the code. 


ft 


MyAnimalList 


Animal[] animals 
int nextlndex 


add(Animal a) 


Building our own Animal-specific list 


public class MyAnimalList 



private Animal[] animals = new Animal[5]; 
private int nextlndex = 0; 


public void add(Animal a) { 

if (nextlndex < animals.length) { 
animals[nextlndex] = a; 


⑽ WcV f—n 

abstract 切?十七 

AN°lakc 


System. out. println (''Animal added at '' + nextlndex); 
nextlndex++; 


public class AnimalTestDrive{ 

public static void main (String[] args) { 
MyAnimalList list = new MyAnimalList(); 
Dog a = new Dog(); 

Cat c = new Cat(); 
list.add(a); 
list.add(c); 


I File Edit Window Help Harm | 


% java AnimalTestDrive 
Animal added at 0 
Animal added at 1 
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the ultimate superclass: Object 


What about wow-Awiwals? Why wot make 
a class generic enough to take awythmg? 


You know where this is heading. We want to change the 
type of the array, along with the add() method argument, to 
something above Something even more generic, more 

abstract than Animal. But how can we do it? We don’t have a 
superclass for Animal. 

Then again, maybe we do... 

Remember those methods of ArrayList? 

Look how the remove, contains, and 
indexOf method all use an object of type... 

Object! 




㈣ 心 

arc ^ 一 . 


ArrayList 


Every class in Java extends 
class Object. 

Class Object is the mother of all classes; it’s 
the superclass of everything. 

Even if you take advantage of polymorphism, 
you still have to create a class with methods 
that take and return your polymorphic type. 

Without a common superclass for everything 
in Java, there’d be no way for the developers 
of Java to create classes with methods that 
could take your custom types... types they never 
knew about when they wrote the ArrayList class. 

So you were making subclasses of class Object 
from the very beginning and you didn’t even 
know it. Every class you write extends Object ， 
without your ever having to say it. But you can 
think of it as though a class you write looks like 
this: 

public class Dog extends Object { } 

But wait a minute, Dog already extends something, Canine. 
That’s OK. The compiler will make Canine extend Object 
instead. Except Canine extends Animal. No problem, then the 
compiler will just make Animal extend Object. 

Any class that doesn’t explicitly extend another 
class, implicitly extends Object. 

So, since Dog extends Canine, it doesn’t directly extend Object 
(although it does extend it indirectly), and the same is true 
for Canine, but Animal does directly extend Object. 


boolean removelObiect elem) ter . Retum s 

二二 

boolean contains(Objecte»em) theob . ect paramete . 

Returns W inheres 


int index 

Returns 

0bie R C 'urns tlTeeleS at this position 

b 00 ^ d S 二口 (reWmS 


or 


in 


the list. 


'true'). 


II more 


(叫二以:仏二 


从 c sW/ a 


Wii\t laW.) 
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So whafs iw this ultra-supcr-wcgaclass Object? 


If you were Java, what behavior would you want every 
object to have? Hmmmm … let’s see... how about a 
method that lets you find out if one object is equal 
to another object? What about a method that can 
tell you the actual class type of that object? Maybe a 
method that gives you a hashcode for the object, so 
you can use the object in hash tables (we’ll talk about 
Java’s hashtables in chapter 17 and appendix B). 

Oh, here’s a good one — a method that prints out a 
String message for that object. 

And what do you know? As if by magic, class Object 
does indeed have methods for those four things. 
That’s not all, though, but these are the ones we 
really care about. 


Object 

boolean equals() 
Class getClass() 
int hashCode() 
String toString() 


SOMt 
0 Jf t\ass 


YourClassHere 


运败 y 山 ss you w\ritc ihhevits a\\ the 

methods of dlass The dbsscs 

you? wiriUch methods you 

didh't cveh khow you had. 


① equals(Object o) 

Dog a = new Dog(); 
Cat c = new Cat(); 


③ hashCode() 

Cat c = new Cat(); 

System.out.println(c.hashCode()); 


if (a.equals(c)) { 

System, out .println (''true; 

} else { 

System .out. println (' 、 false"); 


File Edit Window Help Stop 


% java TestObject 
false 


Tells vou l-f objects avc 
about 诎 at rcall V 

B). 


File Edit Window Help Drop 


% java TestObject 




8202111 


④ toString() 

Cat c = new Cat(); 

System.out.println(c.toString()); 


( 5 ) getClass() 

Cat c = new Cat(); 

System.out.println(c.getClass()); 


£,ldss 



File Edit Window Help LapselntoComa 


% java TestObject 
Cat@7d277f 
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Object and abstract classes 


fJierei£irejio 

Dumb Questions 

Is class Object abstract? 

No. Well, not in the formal 
Java sense anyway. Object is a 
non-abstract class because it’s 
got method implementation 
code that all classes can inherit 
and use out-of-the-box, without 
having to override the methods. 

Then can you override 
the methods in Object? 

Some of them. But some of 
them are marked final, which 
means you can’t override them. 
You’re encouraged (strongly) to 
override hashCode(),equals(), 
and toStringO in your own 
classes, and you’ll learn how to 
do that a little later in the book. 
But some of the methods, like 
getClass(),do things that must 
work in a specific, guaranteed 
way. 

If ArrayList methods are 
generic enough to use Object, 
then what does it mean to say 
ArrayList<DotCom>? I thought 
I was restricting the ArrayList to 
hold only DotCom objects? 

You were restricting it. 

Prior to Java 5.0, ArrayLists 
couldn’t be restricted.They 
were all essentially what you 
get in Java 5.0 today if you write 
ArrayList<Object>. In other 
words, an ArrayList restricted 
to anything that’s an Object, 
which means any object in Java, 
instantiated from any class type! 
We’ll cover the details of this new 
<type> syntax later in the book. 


OK, back to class Object 
being non-abstract (so I guess 
that means it’s concrete), HOW 
can you let somebody make an 
Object object? Isn’t that just 
as weird as making an Animal 

object? 

Good question! Why is 
it acceptable to make a new 
Object instance? Because 
sometimes you just want a 
generic object to use as, well, as 
an object. A lightweight object. 

By far, the most common use of 
an instance of type Object is for 
thread synchronization (which 
you’ll learn about in chapter 15). 
For now, just stick that on the 
back burner and assume that 
you will rarely make objects of 
type Object, even though you 
can. 

So is it fair to say that the 
main purpose for type Object 
is so that you can use it for a 
polymorphic argument and 
return type? Like in ArrayList? 

The Object class serves 
two main purposes: to act as a 
polymorphic type for methods 
that need to work on any class 
that you or anyone else makes, 
and to provide real method code 
that all objects in Java need at 
runtime (and putting them in 
class Object means all other 
classes inherit them). Some of 
the most important methods in 
Object are related to threads, 
and we’ll see those later in the 
book. 


If it’s so good to use 
polymorphic types, why 
don’t you just make ALL your 
methods take and return type 
Object? 

Ahhhh... think about what 
would happen. For one thing, 
you would defeat the whole 
point of 'type-safety’, one 
of Java’s greatest protection 
mechanisms for your code. With 
type-safety, Java guarantees that 
you won’t ask the wrong object 
to do something you meant to 
ask of another object type. Like, 
ask a Ferrari (which you think is a 
Toaster) to cook itself. 

But the truth is, you don’t have 
to worry about that fiery Ferrari 
scenario, even if you do use 
Object references for everything. 
Because when objects are 
referred to by an Object 
reference type, Java thinks it's 
referring to an instance of type 
Object. And that means the 
only methods you’re allowed to 
call on that object are the ones 
declared in class Object! So if 
you were to say: 

Object o = new Ferrari(); 
o.goFast(); //Not legal! 

You wouldn’t even make it past 
the compiler. 

Because Java is a strongly-typed 
language, the compiler checks 
to make sure that you’re calling 
a method on an object that’s 
actually capable of responding. 

In other words, you can call a 
method on an object reference 
only if the class of the reference 
type actually has the method. 
We’ll cover this in much greater 
detail a little later, so don’t worry 
if the picture isn't crystal clear. 
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Using polymorphic references of type Object has a price 


Before you run off and start using type Object for all your ultra-flexible argument and return 
types, you need to consider a little issue of using type Object as a reference. And keep in mind 
that we’re not talking about making instances of type Object; we’re talking about making 
instances of some other type, but using a reference of type Object. 


When you put an object into an ArrayList<Dog>, it goes in as a Dog, and comes out as a Dog: 

Make a” deda 代 d 

ArrayList<Dog> myDogArrayList = new ArrayList<Dog> () ; 七 。 hold P% 。 ^ 出 . 

Dog aDog = new Dog () ; ^~ a 汐 

myDogArrayList. add (aDog) ; Add 如 口 0 3 七 0 七 r .1 i 0 a Po<\ v-c-fcv-cir\dc vav-»aWc- 

Ass-,^ P 05 list to a ^ ^ 

Dog d = myDogArrayList. get (0) ; ^ — (TV>'mk of as tiioujK tKc 

i w because 7 ou used 

But what happens when you declare it as ArrayList<Object>? If you want to make an ArrayList 
that will literally take any kind of Object, you declare it like this: 


Make an A^ a 7^ ,s ^ dedaved 

ArrayList<Ob ject> myDogArrayList = new ArrayList<Ob ject> () ; ^ ^ V^oldi a^7 Object- 

Dog aDog = new Dog () ; <-Make a Po 汐 

myDogArrayList. add (aDog) ; f[dd Po^ *^° 


(These two steps av-c 七 he same ) 


But what happens when you try to get the Dog object and assign it to a Dog reference? 


Dog d = myDogArrayList.get(0); 


MOff iVon ’ 七 dompilc/l iVlicn you use A^v-ayLis-t<Objcd*t>, 七 he gc 七 0 me 七 hod 
vc 七 uvns *tyfc Objcdt TKc Compilcv- knows only the objed 七 -fvom 

Objcdt (son>cvi\)C^C in its inhevi 七 hett) bu 七 i 七 docsn ’ 七 khow i 七 ’s a Doj H 


Everything comes out of an ArrayList<Object> as a reference of type Object ， regardless of what the 
actual object is，or what the reference type was when you added the object to the list. 


The objects go IN 
as SoccerBall, 
Fish, Guitar, and 
Car. 





Objects come out of 
an ArrayList<Object> 
acting like they’re 
generic instances 
of class Object. The 
Compiler cannot 
assume the object 
that comes out is of 
any type other than 
Object. 
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When a Dog loses its Dogness 


Whew a I?og won't act like a l?og 

The problem with having everything treated 
polymorphically as an Object is that the objects 
appear to lose (but not permanently) their 
true essence. The Dog appears to lose its dogness. 
Let’s see what happens when we pass a Dog to 
a method that returns a reference to the same 
Dog object, but declares the return type as type 
Object rather than Dog. 



I dorVt know what youre 
talking about. Sit? Stay? 
bark? Hmmmm... I doiVt 
recall knowing those. 


m 

© 


public void go() { 

Dog aDog = new Dog() 




Dog sameDog 泛 getObject 


'T 


〆 


h 、 S ，’ t 。 如 了 1 七 c 0V>y^ . 


rt 




public Object getObject(Object o) { 

return o; ^Cct^U io s3mC Po^, ^ as ^ 






r — a 代七 ⑽ cx — f ( al 咏 

SSIHf : 士娜 a 


have 


File Edit Window Help Remember 


DogPolyTest.java:10: incompatible types 
found java.lang.Object 

required : Dog 

Dog sameDog = takeObjects(aDog); 
1 error A 


The tomfilcv doesn't kr\oy/ 七 
•tiVmg \rc*twnr\cdl -fv-om rwC*t^od is 
/ ad-tually a P05, so \i ^or!i \ci you 
^ assi^ *i*t io a P05 vc-fcvc^c- (^oull 
see ov\ *tKc pa^c ) 


6,00V 

◎ 


public void go () { 

Dog aDog = new Dog(); 

Object sameDog = getObject(aDog); 

} 

public Object getObject(Object o) { 
return o; 


This y/o\rks (dl'thou^h i-t ir>o*t be vevy 
usc-Pul, as you’ll see *m d rwonr»ch*t) be 匕 duse you 
匕扣 assign Al^YTHIhl^ io a v-c-Pc\rcK>dc of -type 

Object, s\y\u cvciry class passes -the IS-A tes-t 
(or Object Evcvy obje 匕七 ih Java is av\ \y\sUv\U 
tyfc Object, because cvcvy dlass m Java has 

Objcd^t the top o-P its brcc- 
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Objects don't bark. 

So now we know that when an object is 
referenced by a variable declared as type 
Object, it can’t be assigned to a variable 
declared with the actual object’s type. 
And we know that this can happen when 
a return type or argument is declared 
as type Object, as would be the case, 
for example, when the object is put 
into an ArrayList of type Object using 
ArrayList<Object>. But what are the 
implications of this? Is it a problem to 
have to use an Object reference variable 
to refer to a Dog object? Let’s try to call 
Dog methods on our Dog-That-Compiler- 
Thinks-Is-An-Obj ect: 




d og ob^ 



W\\cy\ you yt By\ object -froirw 

dr\ /\^3yLis*t<0bjcd*t> (or ar\y method / 
that declares Objcd-t as -the \rctu\rr\ type), / 
i*t domes as d polymorphic ^ 

■type Object So you have Bv\ Objcd*t 

io C\v\ this dase) a Pog msja^g. 


a 


Object o = al.get(index); 
int i = o.hashCode (); 




— 、 ei-^ bark() ; 


Car\ ； *t do -LWisf! The Object da ss hds v\o ided y/ha*t 
i 七 means 七。 bavkO. Evcr\ *though Y^)W ky\ow i*t s 
really a Pog a 七 *tha*t -the do 叶 iler does/ 七 " 


The compiler decides whether 
you can call a method based 
on the reference type, not the 
actual object type. 


Even if you know the object is capable 
(“•••but it really is a Dog, honest...’’），the 
compiler sees it only as a generic Object. 
For all the compiler knows, you put a 
Button object out there. Or a Microwave 
object. Or some other thing that really 
doesn’t know how to bark. 

The compiler checks the class of the 
reference type — not the object type — to 
see if you can call a method using that 
reference. 


hashCode() 




Object 


d °9 ob ^ 


Object 

equalsQ 

getClass() 

hashCode() 

toString() 



The r^rtliod youVc a 

\rc-fcv-c^dc MUST be *m the dlass o-f 
七 ha 七 \rc-fc\rci^dc type. Docs 灼’七 
wha*t 七 he actual is. 

o.hashCode(); 


The w o w >/ds dedared as 

Objcd*t> so you 乙 dll methods oi^l 

those mrthocU av-c \v\ ^lass Object- 


yt 
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objects are Objects 



^etiw touch with your inner Object. 

An object contains everything it inherits from each of its 
superclasses. That means every object — regardless of its 
actual class type — is also an instance of class Object.That 
means any object in Java can be treated not just as a Dog, 
Button, or Snowboard, but also as an Object. When you 
say new Snowboard (), you get a single object on the 
heap — a Snowboard object — but that Snowboard wraps 
itself around an inner core representing the Object 
(capital “O”）portion of itself. 



Snowboard 

equals() —^ 
getClass() / 
hashCode() / 
toString() J 

turn() 

shred() 

getAir() 

loseControlQ 


Showbodrd mhevi*ts methods 
-from superclass Object, ar\d 
adds -four 



There is or\ly 0MB- objcd*t oy\ heap here. Sr\oy/bod\rd 
object Bu*t i*t 乙 orrta.ms bo*th Snowboard dldss pa\rts of 
itsel-f Bv\d dlass pavb itsel-f. 
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‘Polymorphism 9 means 
‘many forms’. 

You can treat a Snowboard as a 
Snowboard or as an Object. 

If a reference is like a remote control, the 
remote control takes on more and more buttons 
as you move down the inheritance tree. A 
remote control (reference) of type Object has 
only a few buttons — the buttons for the exposed 
methods of class Object. But a remote control 
of type Snowboard includes all the buttons from 
class Object, plus any new buttons (for new 
methods) of class Snowboard. The more specific 
the class, the more buttons it may have. 

Of course that’s not always true; a subclass might 
not add any new methods, but simply override 
the methods of its superclass. The key point is 
that even if the object is of type Snowboard, an 
Object reference to the Snowboard object can’t see 
the Snowboard-specific methods. 


Snowboard S r = new Snowboard() 


Object O 


When you put 
an object in an 
ArrayList<Object>，you 
can treat it only as an 
Object，regardless of 
the type it was when 
you put it in. 

When you get a 
reference from an 
ArrayList<Object>，the 
reference is always of 
type Object 

That means you get an 
Object remote control. 


The Showboavd dor\*brol 

hds more buttons *thar\ 
v*eir«o*tc dorrbrol. The 
Sy\oy/board remote see *thc -full 

object l*t C^y\ ^CCtss all *thc method 

•m Snowboard, mdudmg bo*tK 
"mhevi*tcd Objcd*t methods ar\d *the 
methods -fvom dldss Sr\owbod\rdi* 



Snowboard 

〜 0\A/hwt\ 0 ^ 6 ° 


s 


The Object rc-fcrchdc dar\ see oy\ly -the 
0\>\cc{, parts o+ {\\c Sy\oy/board 
I 七 c^y\ addess ohly -the methods o4* dlass 
Object l*t hds -fcy/cr bu*t*tor\s 
Shoy/bodv-d vcmo*tc dorrbrol. 
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casting objects 



Wait a minute... what good 
is a Dog if it comes out of an 
ArrayList<Object> and it caiVt do 
any Dog things? There’s gotta be a 
way to get the Dog back to a state 
of Dogness... 


I hope it doesn't hurt. 
And what's so wrong with 
staying an Object? OK, I cant 
fetch, sure, but I can give you 
a real nice hashcode. 




C^s^t *thc so - 乙 d I led 乙七 ’ (bu*t 

we how he’s actually a Dog) to 
type Pog, so tha-t you cav\ tv-ca-t 
hirw like the Dog he v-cally is. 


Casting an object reference 
back to its real type. 



It’s really still a Dog object, but if you want to call 
Dog-specific methods, you need a reference declared 
as type Dog. If you’re sure* the object is really a 
Dog, you can make a new Dog reference to it by 
copying the Object reference, and forcing that 
copy to go into a Dog reference variable, using a 
cast (Dog). You can use the new .Dog'reference to 
call .Dog'methods. 


Object o = 
Dog d = 
d.roam () 


t n nH 兑 v 、 



Dog 


*If you’re not sure it’s a Dog, you can use the 
instanceof operator to check. Because if 
you’re wrong when you do the cast, you’ll get a 
ClassCastException at runtime and come to a 
grinding halt. 

if (o instanceof Dog) { 

Dog d = (Dog) o; 
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So now you’ve seen how much Java 
cares about the methods in the 
class of the reference variable. 

You can call a method on an object only if 
the class of the reference variable has that 
method. 



Think of the public methods in your class as 
your contract, your promise to the outside 
world about the things you can do. 


When you write a class, you almost always expose some 
of the methods to code outside the class. To expose a 
method means you make a method accessible, usually by 
marking it public. 

Imagine this scenario: you’re writing code for a small 
business accounting program. A custom application 
for “Simon’s Surf Shop”. The good re¬ 
user that you are, you found an Account 
class that appears to meet your needs 
perfectly, according to its documentation, 
anyway. Each account instance represents 
an individual customer’s account with the 
store. So there you are minding your own 
business invoking the credit() and debit() 
methods on an account object when you realize you 
need to get a balance on an account. No problem — 
there’s a getBalance() method that should do nicely. 

Except... when you invoke the getBalance() method, 
the whole thing blows up at runtime. Forget the 
documentation, the class does not have that method. 
Yikes! 

But that won’t happen to you, because everytime you 
use the dot operator on a reference (a.doStuff()), the 
compiler looks at the reference type (the type ‘a’ was 
declared to be) and checks that class to guarantee the 
class has the method, and that the method does indeed 
take the argument you’re passing and return the kind of 
value you’re expecting to get back. 

Just remember that the compiler checks the class of the 
reference variable, not the class of the actual object at the 
other end of the reference. 


Account 

debit(double amt) 

credit(double amt) 
double getBalanceQ 
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modifying a class tree 


What if you need to change 
the contract? 


OK, pretend you’re a Dog. Your Dog class 
isn’t the only contract that defines who you 
are. Remember, you inherit accessible (which 
usually means public) methods from all of 
your superclasses. 

True, your Dog class defines a contract. 

But not all of your contract. 

Everything in class Canine is part of your 
contract. 

Everything in class Animal is part of your 
contract. 

Everything in class Object is part of your 
contract. 

According to the IS-A test, you are each of 
those things — Canine, Animal, and Object. 

But what if the person who designed your 
class had in mind the Animal simulation 
program, and now he wants to use you (class 
Dog) for a Science Fair Tutorial on Animal 
objects. 

That’s OK, you’re probably reusable for that. 

But what if later he wants to use you for a 
PetShop program? You don’t have any Pet 
behaviors. A Pet needs methods like beFriendly() 
and play(). 

OK, now pretend you’re the Dog class 
programmer. No problem, right? Just add 
some more methods to the Dog class. You 
won’t be breaking anyone else’s code by 
adding methods, since you aren’t touching 
the existing methods that someone else’s code 
might be calling on Dog objects. 

Can you see any drawbacks to that approach 
(adding Pet methods to the Dog class)? 


Think about what YOU would do if YOU were 
the Dog class programmer and needed to 
modify the Dog so that it could do Pet things, 
too. We know that simply adding new Pet be¬ 
haviors (methods) to the Dog class will work, 
and won’t break anyone elses code. 

But... this is a PetShop program. It has more 
than just Dogs! And what if someone wants 
to use your Dog class for a program that has 
wild Dogs? What do you think your options 
might be, and without worrying about how 
Java handles things, just try to imagine how 
you’d like to solve the problem of modifying 
some of your Animal classes to include Pet 
behaviors. 

Stop right now and think about it, 
before you look at the next page where we 
begin to reveal everything. 

(thus rendering the whole exercise completely useless, robbing 
you of your One Big Chance to burn some brain calories) 
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interfaces and polymorphism 


Let's explore some design options 
for reusing some of our existing 
classes in a PctShop program. 

On the next few pages, we’re going to walk through 
some possibilities. We’re not yet worried about 
whether Java can actually do what we come up with. 
We’ll cross that bridge once we have a good idea of 
some of the tradeoffs. 


0 Option one 

We take the easy path, and put pet 
methods in class Animal. 

Pros: 

All the Animals will instantly inherit 
the pet behaviors. We won’t have to 
touch the existing Animal subclasses 
at all, and any Animal subclasses 
created in the future will also get to 
take advantage of inheriting those 
methods. That way, class Animal can 
be used as the polymorphic type in 
any program that wants to treat the 
Animals as pets 

Cons: 

So... when was the last time you 
saw a Hippo at a pet shop? Lion? 

Wolf? Could be dangerous to give 
non-pets pet methods. 


Also, we almost certainly WILL 
have to touch the pet classes 
like Dog and Cat, because (in 
our house, anyway) Dogs 
and Cats tend to imple¬ 
ment pet behaviors 
VERY differently. 


，八 


V ^ ^ ^ ^ 

一 A 


Animal 




Lion 
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modifying existing classes 


② Option two 

We start with Option One, putting the pet methods 
in class Animal, but we make the methods abstract, 
forcing the Animal subclasses to override them. 

Pros: 

That would give us all the benefits of Option One, but with¬ 
out the drawback of having non-pet Animals running around 
with pet methods (like beFriendlyO). All Animal classes 
would have the method (because \Ys in class Animal), but 
because \Ys abstract the non-pet Animal classes won’t 
inherit any functionality. All classes MUST override the 
methods, but they can make the methods ''do-nothings ,/ . 


Cons: 

Because the pet methods in the Animal class are all 
abstract, the concrete Animal subclasses are forced to 
implement all of them. (Remember, all abstract methods 
MUST be implemented by the first concrete subclass 
down the inheritance tree.) What a waste of time! 

You have to sit there and type in each and every 
pet method into each and every concrete non¬ 
pet doss, and all future subclasses as well 
And while this does solve the problem of 
non-pets actually DOING pet things 
(as they would if they inherited pet 
functionality from class Animal), the 
contract is bad. Every non-pet 
class would be announcing to the 
world that it, too, has those 
pet methods, even though 


a '' ^ 







Animal 


the methods wouldn’t 
actually DO anything 
when called. 


This approach doesn’t 
look good at all. It just 
seems wrong to stuff 
everything into class Animal 
that more than one Animal type 
might need, UNLESS it applies to 
ALL Animal subclasses. 




Lion 




Ask me to be friendly. 
No, seriously... ask me. 
I have the method. 
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③ Option three 

Put the pet methods ONLY in the 
classes where they belong. 

Pros: 

No more worries about Hippos greeting you at the 
door or licking your face. The methods are where 
they belong, and ONLY where they belong. Dogs can 
implement the methods and Cats can implement the 
methods, but nobody else has to know about them. 

Com: 

Two Big Problems with this approach. First off, you’d 
have to agree to a protocol, and all programmers of 
pet Animal classes now and in the future would have 
to KNOW about the protocol. By protocol, we mean 
the exact methods that we've decided all pets should 
have. The pet contract without anything to back it up. 
But what if one of the programmers gets it just a tiny 
bit wrong? Like, a method takes a String when it was 
supposed to take an int? Or they named it c/oFriendly() 
instead of beFriendlyO? Since it isn't in a contract, 
the compiler has no way to check you to see if you've 
implemented the methods correctly. Someone 
could easily come along to use the pet Animal 
classes and find that not all of them work 
quite right. 








And second, you don’t get to use 
polymorphism for the pet methods. 
Every class that needs to use 
pet behaviors would have to 
know about each and every 
class! In other words, 
you can’t use Animal 
as the polymorphic 
type now, because the 
compiler won’t let you call 
a Pet method on an Animal 
reference (even if \Ys really a 
Dog object) because class Animal 
doesn’t have the method. 



* 


Dog 

」 
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multiple inheritance? 


So what we REALLY need is: 

♦ A way to have pet behavior in just the pet classes 

♦ A way to guarantee that all pet classes have all of the same 
methods defined (same name, same arguments, same return 
types, no missing methods, etc.), without having to cross your 
fingers and hope all the programmers get it right. 

♦ A way to take advantage of polymorphism so that all pets can have 
their pet methods called, without having to use arguments, return 
types, and arrays for each and every pet class. 


It looks like we need TWO 
superclasses at the top 


二 


一 
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Wolf 
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interfaces and polymorphism 


There's just one problem with the ''two superclasses" approach... 

It’s called “multiple inheritance” 
and it can be a Really Bad Thing. 

That is, if it were possible to do in Java. 

But it isn't, because multiple inheritance has a problem 
known as The Deadly Diamond of Death. 


Deadly Diamond of Death 


“ P 舞… r b 办 

㈣ rr 》 


: la— 舳 . 



CDBurner 

I | 

DVDBurner 




burn() 


burn() 


ComboDrive 




.\ JLV, CPk 吖 


二 C〆 c 
j ：: 二二 ^ 






A language that allows the Deadly Diamond of Death can lead to 
some ugly complexities, because you have to have special rules to 
deal with the potential ambiguities. And extra rules means extra 
work for you both in learning those rules and watching out for 
those “special cases”. Java is supposed to be simple ，with consistent 
rules that don’t blow up under some scenarios. So Java (unlike 
C++) protects you from having to think about the Deadly Dia¬ 
mond of Death. But that brings us back to the original problem! 
How do we handle the Animal/Pet thing? 
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interfaces 


Interface to the rescue! 

Java gives you a solution. An interface. Not a GUI interface, not the generic 
use of the word interface as in, “That’s the public interface for the Button 
class API,” but the Java keyword interface. 

A Java interface solves your multiple inheritance problem by giving you 
much of the polymorphic benefits of multiple inheritance without the pain 
and suffering from the Deadly Diamond of Death (DDD). 

The way in which interfaces side-step the DDD is surprisingly simple: make 
all the methods abstract! That way, the subclass must implement the methods 
(remember, abstract methods must be implemented by the first concrete 
subclass), so at runtime the JVM isn’t confused about which of the two 
inherited versions it’s supposed to call. 



A Java interface is like a 
100% pure abstract class. 

M MWST 


To DEFINE an interface: 


public interface Pet {...} 

\ 

. s f ^ywo^c/ ^ i £ 


To IMPLEMENT an interface: 


public class Dog extends Canine implements Pet {. 

Use ，广二 _ M 
㈤㈤ 一 
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interfaces and polymorphism 


Making and Implementmg 
the Pet interface 


^tead 

X Mass’ 


\ 

public interface Pet { 




v c hcvcv- 


public abstract void beFriendly() 
public abstract void play(); 






to Us. R— 


sew' 
v\o V>od^ 


public class Dog extends Canine implements Pet { 


public void beFriendly() { 

public void play() {..} 


public void roam() {...} 
public void eat() { . . . }( 




<~ - 




iyiS icad of 


s C^\i^oloi 


m. 


吻 ^es 
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Dumb Questions 

Wait a minute, interfaces don't 
really give you multiple inheritance, 
because you can’t put any 
implementation code in them. If all 
the methods are abstract, what does 
an interface really buy you? 

Polymorphism, polymorphism, 
polymorphism. Interfaces are the 
ultimate in flexibility, because if you 
use interfaces instead of concrete 
subclasses (or even abstract superclass 
types) as arguments and return 


types, you can pass anything that 
implements that interface. And think 
about it — with an interface, a class 
doesn’t have to come from just one 
inheritance tree. A class can extend 
one class, and implement an interface. 
But another class might implement 
the same interface, yet come from a 
completely different inheritance tree! 
So you get to treat an object by the 
role it plays, rather than by the class 
type from which it was instantiated. 

In fact, if you wrote your code to use 
interfaces, you wouldn’t even have to 
give anyone a superclass that they had 


to extend. You could just give them 
the interface and say,"Here,’l don’t 
care what kind of class inheritance 
structure you come from, just 
implement this interface and you’ll be 
good to go.” 

The fact that you can’t put in 
implementation code turns out not to 
be a problem for most good designs, 
because most interface methods 
wouldn’t make sense if implemented 
in a generic way. In other words, most 
interface methods would need to 
be overridden even if the methods 
weren’t forced to be abstract. 
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interface polymorphism 


Classes from different inheritance trees 
can implement the same interface. 



When you use a class as a polymorphic type (like an 
array of type Animal or a method that takes a Canine 
argument), the objects you can stick in that type 
must be from the same inheritance tree. But not just 
anywhere in the inheritance tree; the objects must be 
from a class that is a subclass of the polymorphic type. 
An argument of type Canine can accept a Wolf and a 
Dog, but not a Cat or a Hippo. 

But when you use an interface as a polymorphic 
type (like an array of Pets), the objects can be 
from anywhere in the inheritance tree. The only 
requirement is that the objects are from a class that 
implements the interface. Allowing classes in different 
inheritance trees to implement a common interface 
is crucial in the Java API. Do you want an object 
to be able to save its state to a file? Implement the 
Serializable interface. Do you need objects to run 


their methods in a separate thread of execution? 
Implement Runnable. You get the idea. You’ll 
learn more about Serializable and Runnable in later 
chapters, but for now, remember that classes from 
any place in the inheritance tree might need to 
implement those interfaces. Nearly any class might 
want to be saveable or runnable. 

Better still, a class can implement 
multiple interfaces! 

A Dog object IS-A Canine, and IS-A Animal, and 
IS-A Object, all through inheritance. But a Dog IS-A 
Pet through interface implementation, and the Dog 
might implement other interfaces as well. You could 
say: 

public class Dog extends Animal implements 
Pet, Saveable, Paintable { ... } 
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interfaces and polymorphism 



How do you know whether to make a 
class, a subclass, an abstract class, or 
an interface? 

^ Make a class that doesiVt extend anything 

(other than Object) when your new class doesn’t 
pass the IS-A test for any other type. 

^ Make a subclass (in other words, extend a class) 
only when you need to make a more specific 
version of a class and need to override or add 
new behaviors. 

^ Use an abstract class when you want to define 
a template for a group of subclasses, and you 
have at least some implementation code that all 
subclasses could use. Make the class abstract 
when you want to guarantee that nobody can 
make objects of that type. 

^ Use an interface when you want to define a role 
that other classes can play, regardless of where 
those classes are in the inheritance tree. 
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using super 


Invoking the superclass 
version of a method 

What if you make a concrete subclass 
and you need to override a method, but you 
want the behavior in the superclass version of 
the method? In other words, what if you don't 
need to replace the method with an override, 
but you just want to add to it with some 
additional specific code. 

Ahhh... think about the meaning of the 
word 'extends’. One area of good 00 design looks 
at how to design concrete code that’s meant to 
be overridden. In other words, you write method 
code in, say, an abstract class, that does work 
that’s generic enough to support typical concrete 
implementations. But, the concrete code isn’t 
enough to handle all of the subclass-specific 
work. So the subclass overrides the method 
and extends it by adding the rest of the code. 

The keyword super lets you invoke a superclass 
version of an overridden method, from within the 
subclass. 

|-f method Code mside d 

Buzi.y/o\rdRcpo\rt subdldss says ： 

super.runReport() 

method \Y\S\dt 

•the superclass Report will ruy\ 


abstract class Report { su 

void runReport() { 

// set-up report 

} 

void printReport() { 

// generic printing 


class BuzzwordsReport extends Report { 


void runReport() { 

super.runReport(); 電 〆 


buzzwordCompliance() 
printReport(); 


void buzzwordCompliance() {... 


6aW 災―。 a ,d 

t ; 工筇 


A^ s 


super.runReport(); 

A *to subclass objedt 

(Buzzy/ovdRepov* 七 ） will always ddll 

■the subdldss version o-f overridden 
method. polyrwovpKism. 

Bu*t {ht subclass Code ddr\ dall 
supcr.\rur\Rcpo\rtO *to invoke 
superclass version. 





svA\>CV* 6 lass methods 

UdWdH 如 oW»dd ⑼ 

vwRcVortO 


The super keyword is really a 
*to *thc supevdlass povtioh o+ By\ object 
W\\cv\ subclass Code uses super, as m 
supcr.ruhRcpovtO, *thc superclass version of 
method will \ruy\. 
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interfaces and polymorphism 


_BULLET POINTS _ 

y When you don’t want a class to be instantiated (in other words, you don’t 
want anyone to make a new object of that class type) mark the class with the 
abstract keyword. 

y An abstract class can have both abstract and non-abstract methods. 

> If a class has even one abstract method, the class must be marked abstract. 

y An abstract method has no body, and the declaration ends with a semicolon (no 
curly braces). 

y All abstract methods must be implemented in the first concrete subclass in the 
inheritance tree. 

y Every class in Java is either a direct or indirect subclass of class Object (java.lang. 
Object). 

y Methods can be declared with Object arguments and/or return types. 

y You can call methods on an object only if the methods are in the class (or interface) 
used as the reference variable type, regardless of the actual object type. So, a 
reference variable of type Object can be used only to call methods defined in class 
Object, regardless of the type of the object to which the reference refers. 

y A reference variable of type Object can’t be assigned to any other reference type 
without a cast. A cast can be used to assign a reference variable of one type to a 
reference variable of a subtype, but at runtime the cast will fail if the object on the 
heap is NOT of a type compatible with the cast. 

Example: Dog d = (Dog) x.getObject(aDog); 

y All objects come out of an ArrayList<Object> as type Object (meaning, they can be 
referenced only by an Object reference variable, unless you use a cast). 

y Multiple inheritance is not allowed in Java, because of the problems associated with 
the “Deadly Diamond of Death”. That means you can extend only one class (i.e. you 
can have only one immediate superclass). 

y An interface is like a 1 00% pure abstract class. It defines only abstract methods. 

y Create an interface using the interface keyword instead of the word class. 

y Implement an interface using the keyword implements 
Example: Dog implements Pet 

> Your class can implement multiple interfaces. 

y A class that implements an interface must implement all the methods of the 
interface, since all interface methods are implicitly public and abstract 

y To invoke the superclass version of a method from a subclass that’s overridden the 
method, use the super keyword. Example: super. runReport (); 


There's still something 


strange here... you never 
explained how it is that 
ArrayList<Dog> gives back Dog 


references that don’t need to be 
cast, yet the ArrayList class uses 
Object in its methods, not Dog 
(or DotCom or anything else). 
What's the special trick going on 
when you say ArrayList<Dog>? 


You're right for calling it a 
special trick. In fact it is a special 
trick that ArrayList<Dog> gives 
back Dogs without you having 
to do any cast, since it looks like 
ArrayList methods don’t know 
anything about Dogs, or any type 
besides Object. 

The short answer is that the 
compiler puts in the cast for you! 
When you say ArrayList<Dog>, 
there is no special class that has 
methods to take and return Dog 
objects, but instead the <Dog> 
is a signal to the compiler that 
you want the compiler to let 
you put ONLY Dog objects in 
and to stop you if you try to add 
any other type to the list. And 
since the compiler stops you 
from adding anything but Dogs 
to the ArrayList, the compiler 
also knows that its safe to cast 
anything that comes out of that 
ArrayList do a Dog reference. In 
other words, using ArrayList<Dog> 
saves you from having to cast 
the Dog you get back. But it’s 
much more important than that... 
because remember, a cast can 
fail at runtime, and wouldn’t you 
rather have your errors happen 
at compile time rather than, say, 
when your customer is using it for 
something critical? 

But there's a lot more to this story, 
and we’ll get into all the details in 
the Collections chapter. 
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exercise: What’s the Picture? 



Rase 


frivew: 


Here’s your chance to demonstrate your artistic abilities. On the left you’ll 
find sets of class and interface declarations. Your job is to draw the associated 
class diagrams on the right. We did the first one for you. Use a dashed line for 
"implements”and a solid linefor"extends ’： 

WhatS the Picture ? 


1) public interface Foo { } 

public class Bar implements Foo { } 

2 ) 

2) public interface Vinn { } 

public abstract class Vout implements Vinn { } 

public abstract class Muffie implements Whuffie { } 
public class Fluffie extends Muffie { } 
public interface Whuffie { } 



4 ) 


public class Zoop { } 

public class Boop extends Zoop { } 

public class Goop extends Boop { } 


4 ) 


y) public class Gamma extends Delta implements Epsilon { } 
public interface Epsilon { } 
public interface Beta { } 

public class Alpha extends Gamma implements Beta { } 
public class Delta { } 
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puzzle: Pool Puzzle 




Your job is to take code snippets from the pool and 
place them into the blank lines in the code and out¬ 
put. You may use the same snippet more than once, 
and you won’t need to use all the snippets. Your 
goal is to make a set of classes that will compile 
and run and produce the output listed. 


Nose { 


abstract class Picasso implements 


return 7 


class 


class 


return 5 


Note: Each snippet 
from the pool can be 
used more than once! 


Acts(); 
Nose(); 
Of76(); 
Clowns(); 
Picasso。; 

Of76 [ ] i = new Nose[3]; 
Of76 [3] i; 

Nose [ ] i = new Nose(); 
Nose [ ] i = new Nose[3]; 


class 
extends 
interface 
implements 


public 


extends Clowns { 


public static void main(String [] args) { 


i[0] 

i[l] 

i[2] 


=new 
=new 
=new 


for(int x = 0; x < 3; x++) { 
System.out.println(_ 


.getClass()); 


Output I File Edit Window Help BeAfraid 


% java _ 

5 class Acts 
7 class Clowns 
Of 7 6 


public int iMethod(); 
public int iMethod {} 
public int iMethod () { 
public int iMethod () {} 


class 
5 class 
7 class 

7 public class 


i.iMethod(x) 
i(x).iMethod[] 
i[x].iMethod() 
i[x].iMethod[] 


Acts 
Nose 
Of76 
Clowns 
Picasso 
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E^epcise Solutions 


interfaces and polymorphism 


WhatS the Picture ? 





-- -- *\ 

Cm-tcv-fadc) l 

Bpsi/on I 

* —、 _- - 

Pel-ta 



L_J 



- - - — > 

Cm-tcr-fadc) l 

Beia j 




L__J 




Alfha 


WhatS the declaration ? 


2J fublid abs*tvad*t dlass Top {} 
public dlass Tip e%*ter\ds Top { } 


3 ) 

4) 


public abs*tv-ad*t dldss Fee { } 

public abs*trad*t dlass Fi c%*ter\ds Fee { } 

public m*tcr-fadc Foo { } 

public, dldss Bar i 叶 lemerrb Foo { } 

public dlass Baz* extends Bav { } 



public 'm*ter-fade 'Z-C^ { } 

public dlass implcmey\*b ^.c*ta { } 

public 'm*tcv-fade Beta { } 

public, dldss Delia e%*ter\ds Alpha implements Bc*ta { } 
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puzzle solution 



interface Nose { 

public int iMe+hod(); 

} 

abstract class Picasso implements N 0 S 6 { 

public int iMe+hod( ) { 

return 7; 

} 

} 

class Clowns extends Picasso { } 

class Acts extends Picasso { 
public int iMe+hod( ) { 

return 5; 


public claSS Of76 extends Clowns { 

public static void main(String [] args) { 

Nose [ ] i = new Nose [3] : 
i [ 0 ] = new Acts() : 
i[ 1 ] = new Clowns( ) : 
i[2] = new Of76(); 

for(int x = 0; x < 3; x++) { 

System.out.println( i [x] . iMethod( ) 

+ " iJ + i [x].getClass()); 


Output 
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9 constructors and garbage collection 



Life and Death 
of an Object 


...then he said, — 

^ ''I can’t feel my legs!" and 
I said ''Joe! Stay with me Joe! 
But it was... too late. The garbage 
collector came and... he was gone. 
^_ Best object I ever had. 


Objects are born and objects die. You’re in charge of an object’s lifecycle. 

You decide when and how to construct it. You decide when to destroy it. Except you don’t 
actually destroy the object yourself, you simply abandon it. But once it’s abandoned, the 
heartless Garbage Collector (gc) can vaporize it, reclaiming the memory that object was 
using. If you’re gonna write Java, you’re gonna create objects. Sooner or later, you’re gonna 
have to let some of them go, or risk running out of RAM. In this chapter we look at how objects 
are created, where they live while they’re alive, and how to keep or abandon them efficiently. 
That means we’ll talk about the heap, the stack, scope, constructors, super constructors, null 
references, and more. Warning: this chapter contains material about object death that some 
may find disturbing. Best not to get too attached. 


this is a new chapter 235 



the stack and the heap 

The Stack and the Heap: where things live 


Before we can understand what really happens when 
you create an object, we have to step back a bit. We 
need to learn more about where everything lives 
(and for how long) in Java. That means we need to 
learn more about the Stack and the Heap. In Java, we 
(programmers) care about two areas of memory — the 
one where objects live (the heap), and the one 
where method invocations and local variables live 
(the stack). When a JVM starts up, it gets a chunk of 
memory from the underlying OS, and uses it to run 
your Java program. How much memory, and whether 
or not you can tweak it, is dependent on which 
version of the JVM (and on which platform) you’re 

The Stack 


Where method invocations 
and local variables live 



running. But usually you won’t have anything to say 
about it. And with good programming, you probably 
won’t care (more on that a little later). 

We know that all objects live on the garbage-collectible 
heap, but we haven’t yet looked at where variables 
live. And where a variable lives depends on what kind 
of variable it is. And by “kind”，we don’t mean type 
(i.e. primitive or object reference). The two kinds of 
variables whose lives we care about now are instance 
variables and /oca/variables. Local variables are also 
known as stack variables, which is a big clue for where 
they live. 



Instance Variables 


Local Variables 


Instance variables are declared inside a class but not 
inside a method. They represent the "fields” that each 
individual object has (which can be filled with different 
values for each instance of the class). Instance variables 
live inside the object they belong to. 


public class Duck { 


» 


s a 


int 


认 s. 私 


Local variables are declared inside a method, including 
method parameters. They’re temporary, and live only as 
long as the method is on the stack (in other words, as long as 
the method has not reached the closing curly brace). 


public void foo(int x) { 


int i = x + 
boolean b = 


3; 

true; 
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Methods are stacked 

When you call a method, the method lands on 
the top of a call stack. That new thing that’s 
actually pushed onto the stack is the stack 
frame, and it holds the state of the method 
including which line of code is executing, and 
the values of all local variables. 

The method at the top of the stack is always 
the currently-running method for that stack 
(for now, assume there’s only one stack,but in 
chapter 14 we’ll add more.) A method stays on 
the stack until the method hits its closing curly 
brace (which means the method’s done). If 
method/oof J calls method bar(), method bar() is 
stacked on top of method/oof 


A call stack with two methods 








I -fooO 

bottom of s ^ k 


variables 
fih^ludihg 


The method on the top of the 
stack is always the currently- 
executing method. 


public void doStuff() { 
boolean b = true; 
go (4); 

} 

public void go(int x) { 
int z = x + 24; 
crazy(); 

// imagine more code here 

} 

public void crazy() { 

char c = ; 


A stack scenario 

The code on the left is a snippet (we don’t care what the rest of the 
class looks like) with three methods. The first method (doStuffQ) calls 
the second method (go()), and the second method calls the third 
(crazy()). Each method declares one local variable within the body 
of the method, and method go() also declares a parameter variable 
(which means go() has two local variables). 


① 


Code from another 
class calls doStuff(), 
and doStuff () goes 
into a stack frame 
at the top of the 
stack.The boolean 
variable named 'b* 


goes on the doStuff() 
stack frame. 


doS^tu-f-fO 


② doStuff () calls go() y 
go() is pushed on 
top of the stack. 
Variables V and 'z 
are in the go() stack 
frame. 



③ go() calls crazyO, 
crazy() is now on the 
top of the stack, 
with variable 'c in 
the frame. 



^ 4 ^ crazy() completes, 
and its stack frame is 


popped off the stack. 
Execution goes back 
to the go() method, 
and picks up at the 
line following the call 
to crazy(). 
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object references on the stack 


What about local variables that arc objects? 

Remember, a non-primitive variable holds a reference to an 
object, not the object itself. You already know where objects 
live — on the heap. It doesn’t matter where they’re declared or 
created. If the local variable is a reference to an object，only 
the variable (the reference/remote control) goes on the stack. 

The object itself still goes in the heap. 


public class StackRef 
public void foof() 
barf(); 


public void barf() { 

Duck d = new Duck(24); 




總以 r 



a is i eJed 


^tJiereiqre^np 

Dumb Questions 

I One more time, WHY are we learning the 
whole stack/heap thing? How does this help me? 
Do I really need to learn about it? 

Knowing the fundamentals of the Java 
Stack and Heap is crucial if you want to understand 
variable scope, object creation issues, memory 
management, threads, and exception handling. 

We cover threads and exception handling in later 
chapters but the others you’ll learn in this one. You 
do not need to know anything about how the Stack 
and Heap are implemented in any particular JVM 
and/or platform. Everything you need to know 
about the Stack and Heap is on this page and the 
previous one. If you nail these pages, all the other 
topics that depend on your knowing this stuff will 
go much, much, much easier. Once again, some day 
you will SO thank us for shoving Stacks and Heaps 
down your throat. 


— BULLET POINTS _ 

> Java has two areas of memory we care about: 
the Stack and the Heap. 

y Instance variables are variables declared 
inside a class but outside any method. 

y Local variables are variables declared inside a 
method or method parameter. 

y All local variables live on the stack, in the 
frame corresponding to the method where the 
variables are declared. 

y Object reference variables work just like primi¬ 
tive variables—if the reference is declared as a 
local variable, it goes on the stack. 

y All objects live in the heap, regardless of 
whether the reference is a local or instance 
variable. 
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If local variables live on the stack, 
wherTdo instance variables live? 

， 个 ■ ■ 

When you say new CellPhone(), Java has to make 
space on the Heap for that CellPhone. But how much 
space? Enough for the object, which means enough to 
house all of the object’s instance variables. That’s right, 
instance variables live on the Heap, inside the object 
they belong to. 

Remember that the values of an object’s instance 
variables live inside the object. If the instance variables 
are all primitives, Java makes space for the instance 
variables based on the primitive type. An int needs 
32 bits, a long 64 bits, etc. Java doesn’t care about the 
value inside primitive variables; the bit-size of an int 
variable is the same (32 bits) whether the value of the 
int is 32,000,000 or 32. 

But what if the instance variables are objects} What if 
CellPhone HAS-A Antenna? In other words, CellPhone 
has a reference variable of type Antenna. 

When the new object has instance variables that are 
object references rather than primitives, the real 
question is: does the object need space for all of 
the objects it holds references to? The answer is, not 
exactly. No matter what, Java has to make space for the 
instance variable values. But remember that a reference 
variable value is not the whole object, but merely a remote 
control to the object. So if CellPhone has an instance 
variable declared as the non-primitive type Antenna, 
Java makes space within the CellPhone object only for 
the Antenna’s remote control (i.e. reference variable) but 
not the Antenna object. 

Well then when does the Antenna object get space on 
the Heap? First we have to find out when the Antenna 
object itself is created. That depends on the instance 
variable declaration. If the instance variable is declared 
but no object is assigned to it, then only the space for 
the reference variable (the remote control) is created. 

private Antenna ant; 

No actual Antenna object is made on the heap unless 
or until the reference variable is assigned a new 
Antenna object. 

private Antenna ant = new Antenna(); 


CellPhone object 



Object wi*th *tv/o p\rimi*tivc va\riablcs. 

Spade -fo\r variables lives \y\ object 



wi*th oy\C ^o^-p\rimi*tivc va\riablc— 

a Yt^Crtr\Ct *to By\ ^[y\{,cy\y\B objcd*t ； bu*t y\o d6*tual 
objcd*t This is y/ha 七 you yt i-f you 
dcdla\rc 七 he variable bu 七 do 灼’七 mi*tializ^ i 七 

a 灼 ad*tudl object 

public class CellPhone { 
private Antenna ant; 



p\rimi*tivc variable ； 

vav-iablc is assi^ed a new 


public class CellPhone { 

private Antenna ant = new Antenna(); 
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object creation 

The miracle of object creation 

Now that you know where variables and objects live, we can dive into 
the mysterious world of object creation. Remember the three steps 
of object declaration and assignment: declare a reference variable, 
create an object, and assign the object to the reference. 

But until now, step two — where a miracle occurs and the new object 
is “born” 一 has remained a Big Mystery. Prepare to learn the facts of 
object life. Hope you’re not squeamish. 


Review the 3 steps of object 
declaration, creation and assignment: 


㈣ 


o 


Declare a reference 
variable 


Duck myDuck = new Duck ()； 



Duck reference 





Create an object 




’ r Duck myDuck = new Duck ()； 

x l Vect- 


\\\t ^ Link the object and 

卜 'T 以 0 咖 作 6 re f erence 

Duck myDuck (=)new Duck () 





Duck object 
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Are we calling a method named Duck()? 
Because it sure looks like it. 


Duck myDuck = new Due 






No. 


We’re calling the Duck constructor. 


A constructor does look and feel a lot like a method, but it’s not 
a method. It’s got the code that runs when you say new. In other 
words, the code that runs when you instantiate an object. 

The only way to invoke a constructor is with the keyword new 
followed by the class name. The JVM finds that class and invokes 
the constructor in that class. (OK, technically this isn’t the only 
way to invoke a constructor. But it’s the only way to do it from 
outside a constructor. You can call a constructor from within 
another constructor, with restrictions, but we’ll get into all that 
later in the chapter.) 

But where is the constructor? 

If we didn’t write it, who did? 


A constructor has the 

code that runs when you 
instantiate an object. In 
other words, the code that 
runs when you say new on 
a class type. 

Every class you create has 
a constructor, even if you 
don’t write it yourself. 


You can write a constructor for your class (we’re about to do 
that), but if you don’t, the compiler writes one for you! 

Here’s what the compiler’s default constructor looks like: 


public Duck() { 


Notice something missing? How is this ,, 

different from a method? , as , C V1 

匕丁… 一 daW 

- ， 6\dss 

public Duck() { 

// constructor code goes here 


It 〜-也。 d 

{{ ^k(r p " hd 
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constructing a new Duck 


Construct a Puck 

The key feature of a constructor is that it runs 
before the object can be assigned to a reference. 
That means you get a chance to step in and 
do things to get the object ready for use. In 
other words, before anyone can use the remote 
control for an object, the object has a chance to 
help construct itself. In our Duck constructor, 
we’re not doing anything useful, but it still 
demonstrates the sequence of events. 


public class Duck { 

public Duck() { 

System, out .printIn (''Quack; 





The constructor gives 
you a chance to step into 
the middle of new. 


public class UseADuck { 

public static void main (String[] args) 
Duck d = new Duck(); 

> } ^ ^ 


File Edit Window Help Quack 


% java UseADuck 
Quack 


e^^rpen your pencil 


A constructor lets you jump into the middle 
of the object creation step — into the middle 
of new. Can you imagine conditions where 
that would be useful? Which of these might 
be useful in a Car class constructor, if the Car 


is part of a Racing Game? Check off the ones 
that you came up with a scenario for. 


□ Increment a counter to track how many objects of this class type 
have been made. 

□ Assign runtime-specific state (data about what’s happening NOW). 

□ Assign values to the object’s important instance variables. 

□ Get and save a reference to the object that’s creating the new object. 

□ Add the object to an ArrayList. 

□ Create HAS-A objects. 

□ _(your idea here) 
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Initializing the state of a new Puck 

Most people use constructors to initialize the state of an object. 
In other words, to make and assign values to the object’s 
instance variables. 

public Duck() { 

size = 34; 

} 

That’s all well and good when the Duck class developer knows 
how big the Duck object should be. But what if we want the 
programmer who is using Duck to decide how big a particular 
Duck should be? 

Imagine the Duck has a size instance variable, and you want the 
programmer using your Duck class to set the size of the new 
Duck. How could you do it? 

Well, you could add a setSize() setter method to the class. But 
that leaves the Duck temporarily without a size*, and forces the 
Duck user to write two statements — one to create the Duck, and 
one to call the setSize() method. The code below uses a setter 
method to set the initial size of the new Duck. 


public class Duck { 

int size; ^ t 


public Duck() { 

System, out.println (''Quack") 



public void setSize(int newSize) 
size = newSize; 




public class UseADuck { 


public static void main (String[] args){ 
Duck d = new Duck(); 

d.setSize(42); 

> io 




Instance variables do have a default value. 0 or 


0.0 for numeric primitives, false for booleans, and 
null for references. 



Why do you need to write 
a constructor if the compiler 
writes one for you? 

If you need code to help 
initialize your object and get 
it ready for use, you’ll have to 
write your own constructor. You 
might, for example, be depen¬ 
dent on input from the user 
before you can finish making 
the object ready.There's another 
reason you might have to write 
a constructor, even if you don’t 
need any constructor code 
yourself. It has to do with your 
superclass constructor, and we’ll 
talk about that in a few minutes. 


How can you tell a con¬ 
structor from a method? Can 
you also have a method that's 
the same name as the class? 


Java lets you declare a 
method with the same name as 
your class. That doesn’t make it 
a constructor, though.The thing 
that separates a method from a 
constructor is the return type. 
Methods must have a return 
type, but constructors cannot 
have a return type. 


Are constructors inher¬ 
ited? If you don’t provide a 
constructor but your superclass 
does, do you get the superclass 
constructor instead of the 
default? 

Nope. Constructors are 
not inherited. We’ll look at that in 
just a few pages. 
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Using the constructor to initialize 
important Puck state* 

If an object shouldn’t be used until one or 
more parts of its state (instance variables) have 
been initialized, don’t let anyone get ahold of 
a Duck object until you’re finished initializing! 

It’s usually way too risky to let someone make — 
and get a reference to — a new Duck object that 
isn’t quite ready for use until that someone turns 
around and calls the setSize() method. How will 
the Duck-user even know that he’s required to call 
the setter method after making the new Duck? 

The best place to put initialization code is in the 
constructor. And all you need to do is make a 
constructor with arguments. 

public class Duck { 
int size; 


Let the user make a new Duck 
and set the Ducks size all in 
one call. The call to new. 
The call to the Duck 
constructor. 


O 










public Duck(int duckSize) { 

System.out.println (''Quack A, ); 


size 


duckSize 


Use value -to sti 

s\zjc *ms*bav\6c vav»aWc- 


System, out .println (''size is 


size 




； s 


public class UseADuck { 

public static void main (String[] args) { 
Duck d = new Duck(42); 











tt: 




File Edit Window Help Honk 


% java UseADuck 


Quack 

size is 42 


*Not to imply that not all Duck state is not unimportant. 
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Make it easy to make a l?uck 

sure you have a wo-arg constructor 


What happens if the Duck constructor takes an argument? 

Think about it. On the previous page, there’s only one Duck 
constructor — and it takes an int argument for the size of the 
Duck. That might not be a big problem, but it does make it 
harder for a programmer to create a new Duck object, especially 
if the programmer doesn’t know what the size of a Duck should 
be. Wouldn’t it be helpful to have a default size for a Duck, so 
that if the user doesn’t know an appropriate size, he can still 
make a Duck that works? 

Imagine that you want Duck users to have TWO options 
for making a Duck — one where they supply the Duck 
size (as the constructor argument) and one where they 
don’t specify a size and thus get your default Duck size. 

You can’t do this cleanly with just a single constructor. 
Remember, if a method (or constructor — same rules) has 
a parameter, you must pass an appropriate argument when 
you invoke that method or constructor. You can’t just say, “If 
someone doesn’t pass anything to the constructor, then use 
the default size”，because they won’t even be able to compile 
without sending an int argument to the constructor call. You 
could do something clunkly like this: 


public class Duck { 

int size; ' s 

W D kr t S . H 丄 

public Duck (int newSize) { -#yo, i\ 

if (newSize == 0) { 


size 


} else { 


size 


27 


newSize 




But that means the programmer making a new Duck object has 
to know that passing a “0” is the protocol for getting the default 
Duck size. Pretty ugly. What if the other programmer doesn’t 
know that? Or what if he really does want a zero-size Duck? 
(Assuming a zero-sized Duck is allowed. If you don’t want 
zero-sized Duck objects, put validation code in the constructor 
to prevent it.) The point is, it might not always be possible 
to distinguish between a genuine U I want zero for the size” 
constructor argument and a “I’m sending zero so you’ll give 
me the default size, whatever that is” constructor argument. 


You really want TWO ways to 
make a new Duck: 

public class Duck2 { 

int size; 

public Duck2() { 

// supply default size 
size = 27; 

} 

public Duck2(int duckSize) { 
// use duckSize parameter 
size = duckSize; 


To make a Duck when you know the size: 
Duck2 d = new Duck2(15); 

To make a Duck when you do not know 
the size: 

Duck2 d2 = new Duck2(); 

So this two-options-to-make-a-Duck idea 
needs two constructors. One that takes 
an int and one that doesn’t. If you have 
more than one constructor in a class, 
it means you have OV6lflOQd6d 
constructors. 
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overloaded and default constructors 


doesn't the compiler always 
make a wo-arg constructor 

for you? 吵 ! 

You might think that if you write only 
a constructor with arguments, the 
compiler will see that you don’t have a 
no-arg constructor, and stick one in for 
you. But that’s not how it works. The 
compiler gets involved with constructor¬ 
making only if you don’t say anything at all 
about constructors. 

If you write a constructor that 
takes arguments, and you still 
want a no-arg constructor, 
you’ll have to build the no-arg 
constructor yourself! 

As soon as you provide a constructor, 

ANY kind of constructor, the compiler 
backs off and says, “OK Buddy, looks like 
you’re in charge of constructors now.” 

If you have more than one 
constructor in a class, the 
constructors MUST have 
different argument lists. 

The argument list includes the order 
and types of the arguments. As long as 
they’re different, you can have more 
than one constructor. You can do this 
with methods as well, but we’ll get to that 
in another chapter. 
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Overloaded constructors means you have 
more than one constructor in your class. 

To compile, each constructor must have a 
different argument list! 


The class below is legal because all four constructors have 
different argument lists. If you had two constructors that took 
only an int，for example, the class wouldn’t compile. What you 
name the parameter variable doesn’t count. It’s the variable 
type (int, Dog, etc.) and order that matters. You can have two 
constructors that have identical types, as long as the order is 
different. A constructor that takes a String followed by an int, is 
not the same as one that takes an int followed by a String. 




iblic class Mushroom 


public Mushroom (int S j.Z6 


public Mushroom ( ) { } 

public Mushroom (boolean isMagic) 


• 以 ， s or y.ot, 




avy, m 

Vt，s 


public Mushroom (boolean isMagic, int size) { }) … • 、七 ’ s 

从 c s •奴 as wU 


so 


public Mushroom (int size , boolean isMagic) { } 


BULLET POINT 



Instance variables live within the object they belong to, on 
the Heap. 

If the instance variable is a reference to an object, both 
the reference and the object it refers to are on the Heap. 

A constructor is the code that runs when you say new on 
a class type. 

A constructor must have the same name as the class, and 
must not have a return type. 

You can use a constructor to initialize the state (i.e. the 
instance variables) of the object being constructed. 

If you don’t put a constructor in your class, the compiler 
will put in a default constructor. 

The default constructor is always a no-arg constructor. 

If you put a constructor—any constructor—in your class, 
the compiler will not build the default constructor. 


y If you want a no-arg constructor, and you’ve already put 
in a constructor with arguments, you'll have to build the 
no-arg constructor yourself. 

y Always provide a no-arg constructor if you can, to make it 
easy for programmers to make a working object. Supply 
default values. 

y Overloaded constructors means you have more than one 
constructor in your class. 

^ Overloaded constructors must have different argument 
lists. 

y You cannot have two constructors with the same 

argument lists. An argument list includes the order and/or 
type of arguments. 

> Instance variables are assigned a default value, even 
when you don’t explicitly assign one. The default values 
are 0/0.0/false for primitives, and null for references. 
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overloaded constructors 


t^farpen your pencil 

Match the new I 


Duck () call with the constructor 
that runs when that Duck is instantiated. We did 
the easy one to get you started. 


public class TestDuck { 

public static void main(String[] args){ 

int weight = 8; 
float density = 2.3F; 

String name = 、 'Donald 〃 ； 
long[] feathers = {1,2,3,4,5,6}; 
boolean canFly = true; 
int airspeed = 22; 


Duck[] d = new Duck[7]; 
d[0] = new Duck(); 
d[l] = new Duck(density, weight); 
d[2] = new Duck(name , feathers); 
d[3] = new Duck(canFly); 
d[4] = new Duck(3.3F, airspeed); 
d[5] = new Duck(false); 
d[6] = new Duck(airspeed, density); 


class Duck { 

int pounds = 6; 

float floatability = 2 . IF; 

String name = ' 、 Generic 〃； 

long[] feathers = {1,2,3,4,5,6,7}; 

boolean canFly = true; 

int maxSpeed = 25; 

public Duck() { 

System, out .print In (''type 1 duck"); 

} 

public Duck (boolean fly) { 
canFly = fly; 

System, out .printIn (''type 2 duck"); 

} 

public Duck(String n, long[] f) { 

name = n; 
feathers = f; 

System, out .printIn (''type 3 duck"); 

} 

public Duck (int w, float f) { 
pounds = w; 
floatability = f; 

System, out .print In (''type 4 duck"); 

} 

public Duck (float density, int max) { 
floatability = density; 
maxSpeed = max; 

System, out .printIn (''type 5 duck"); 


Earlier you said that it’s good to have a no-argu¬ 
ment constructor so that if people call the no-arg con¬ 
structor, we can supply default values for the "missing” 
arguments. But aren’t there times when it’s impossible to 
come up with defaults? Are there times when you should 
not have a no-arg constructor in your class? 

You’re right.There are times when a no-arg construc¬ 
tor doesn’t make sense. You’ll see this in the Java API — some 
classes don’t have a no-arg constructor.The Color class, for 
example, represents a... color. Color objects are used to, for 
example, set or change the color of a screen font or GUI 
button. When you make a Color instance, that instance is 
of a particular color (you know, Death-by-Chocolate Brown, 
Blue-Screen-of-Death Blue, Scandalous Red, etc.). If you 
make a Color object, you must specify the color in some way. 

Color c = new Color(3,45,200); 


(We’re using three ints for RGB values here. We’ll get into 
using Color later, in the Swing chapters.) Otherwise, what 
would you get? The Java API programmers could have de¬ 
cided that if you call a no-arg Color constructor you’ll get a 
lovely shade of mauve. But good taste prevailed. 

If you try to make a Color without supplying an argument: 

Color c = new Color(); 

The compiler freaks out because it can’t find a matching no- 
arg constructor in the Color class. 

^N^^di^/Vindovi^eT^topBeingStupi^^^^^^ 


cannot resolve symbol 
: constructor Color() 
location : class 
java.awt.Color 
Color c = new Color(); 

A 

1 error 
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Naworcvicw: four things to 
remember about constructors 


① 


A constructor is the code that runs when 
somebody says new on a class type 


Duck d = new Duck(); 



② 


A constructor must have the same name 
as the class, and no return type 


public Duck(int size) 



} 


③ 


If you don’t put a constructor in your class, 
the compiler puts in a default constructor. 
The default constructor is always a no-arg 
constructor. 


public Duck() { } 


④ 


You can have more than one constructor in your class, 
as long as the argument lists are different. Having 
more than one constructor in a class means you have 
overloaded constructors. 

^ - 作 


public Duck() { } 


public Duck(int size) { } 


public Duck(String name) { } 


public Duck(String name , 


int size) { } 


Doing all the Brain Barbells has been shown to produce a 42% increase in 
neuron size. And you know what they say, “Big neurons …” 


What about superclasses? 

When you make a Dog, 
should the Canine 
constructor run too? 

If the superclass is abstract, 
should it even have a 
constructor? 

We’ll look at this on the next 
few pages, so stop now and 
think about the implications of 
constructors and superclasses. 


^Jiereiqrejio 

Dumb Questions 

Do constructors have to be public? 

No. Constructors can be public, 
private, or default (which means no access 
modifier at all). We’ll look more at default 
access in chapter 16 and appendix B. 

How could a private constructoir 
ever be useful? Nobody could ever call it, 
so nobody could ever make a new object! 

But that’s not exactly right. Marking 
something private doesn’t mean nobody 
can access it, it just means that nobody 
outside the class can access it. Bet you’re 
thinking "Catch 22': Only code from the 
same class as the class-with-private-con- 
structor can make a new object from that 
class, but without first making an object, 
how do you ever get to run code from that 
class in the first place? How do you ever get 
to anything in that class? Patience grasshop¬ 
per. We’ll get there in the next chapter. 

you are here ► 249 






space for an object’s superclass parts 

Wait a minute... wc never I?1I? talk about 
superclasses and inheritance and how that all 
fits iw with constructors. 


Here’s where it gets fun. Remember from the last chapter, the part where we looked at 
the Snowboard object wrapping around an inner core representing the Object portion 
of the Snowboard class? The Big Point there was that every object holds not just its own 
declared instance variables, but also everything from its superclasses (which, at a minimum, 
means class Object, since every class extends Object). 

So when an object is created (because somebody said new; there is no other way to create 
an object other than someone, somewhere saying new on the class type), the object 
gets space for all the instance variables, from all the way up the inheritance tree. Think 
about it for a moment... a superclass might have setter methods encapsulating a private 
variable. But that variable has to live somewhere. When an object is created, it’s almost as 
though multiple objects materialize — the object being new’d and one object per each 
superclass. Conceptually, though, it’s much better to think of it like the picture below, 
where the object being created has layers of itself representing each superclass. 


Object 

Foo a; 
int b; 
intc; 


equalsQ 

getClass() 

hashCode() 

toString() 


hds ir\s*tar\de variables 
cr\dapsula*tcd by addess methods. 


Those 'ms*tay\de variables arc 
drca*ted ar\y subclass is 

(These 


RBAL variables, bu*t y/c 

doY\{, dare wha*t they ave s'mde 
thcyVc cy\dapsula*tcdi) 


Snowboard 

Foox 

Fooy 

intz 


turn() 

shred() 

getAir() 

loseControl() 


Sr\oy/boa\rd dlso hds ms 七 
variables i*ts ovm, so *to mdke 
a Snowboard objed*t Y\ccd 
spade -for the ms-ta^de variables 
<^f bo*th classes. 


A single 



There is or\ly 0MB object ov\ heap here. A 
Sr\oy/bod\rd object Bu*t i*t dor\*tams bo*th 
Showbodrd parts o-f i*Uel-f Bv\d the f b jed 七 pav-b 
itself. ^\ll ir\s*tay\dc variables -from bo*th classes have 
七 。 be here. 
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The role of superclass constructors 
in an object's life. 


constructors and gc 


All the constructors in an object’s inheritance 
tree must run when you make a new object 

Let that sink in. 


That means every superclass has a constructor 
(because every class has a constructor), and each 
constructor up the hierarchy runs at the time an 
object of a subclass is created. 

Saying new is a Big Deal. It starts the 
whole constructor chain reaction. And yes, 
even abstract classes have constructors. 

Although you can never say new on an 
abstract class, an abstract class is still 
a superclass, so its constructor runs 
when someone makes an instance of a 
concrete subclass. 


The super constructors run to build 
out the superclass parts of the object. 

Remember, a subclass might inherit 
methods that depend on superclass state 
(in other words, the value of instance variables 
in the superclass). For an object to be fully- 
formed, all the superclass parts of itself must be 
fully-formed, and that’s why the super constructor 
must run. All instance variables from every class 
in the inheritance tree have to be declared and 
initialized. Even if Animal has instance variables 
that Hippo doesn’t inherit (if the variables are 
private, for example), the Hippo still depends on 
the Animal methods that use those variables. 

When a constructor runs, it immediately calls its 
superclass constructor, all the way up the chain 
until you get to the class Object constructor. 



A single Hippo objed*t oy \ heap 



A new Hippo object also IS-A Animal 
and IS-A Object. If you want to make a 
Hippo, you must also make the Animal 
and Object parts of the Hippo. 

This all happens in a process called 

Constructor Chaining. 


On the next few pages, you’ll learn how superclass 
constructors are called, and how you can call 
them yourself. You’ll also learn what to do if your 
superclass constructor has arguments! 
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object construction 


Making a Hippo means making the 
Animal and Object parts too... 


public class Animal { 
public Animal() { 

Sys tem. out. pr in tin (''Making an Animal 〃）； 


public class Hippo extends Animal { 
public Hippo() { 

Sys tem. out. pr in tin (''Making a Hippo ; 


public class TestHippo { 

public static void main (String[] args) { 
System, out .pr in tin (''Starting. . •〃）； 
Hippo h = new Hippo(); 


ir^^rpen your pencil — 

What’s the real output? Given the 
code on the left, what prints out 
when you run TestHippo? A or B? 

(the answer is at the bottom of the page) 


A 


File Edit Window Help Swear 


% java TestHippo 
Starting •… 
Making an Animal 
Making a Hippo 


B 


File Edit Window Help Swear 


% java TestHippo 
Starting •… 
Making a Hippo 
Making an Animal 


Code from another 
class says new 
Hippo () and the 
Hippo() constructor 
goes into a stack 
frame at the top of 
the stack. 



^ 2 ) Hippo() invokes 
the superclass 
constructor which 
pushes the Animal() 
constructor onto the 
top of the stack. 



^ 3 ^ Animal() invokes 
the superclass 
constructor which 
pushes the Object() 
constructor onto 
the top of the stack, 
since Object is the 
superclass of Animal. 



^ 4 ^ Object() completes, 
and its stack frame 


is popped off the 
stack. Execution goes 
back to the Animal() 
constructor, and 
picks up at the line 
following AnimaFs 
call to its superclass 
constructor 
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How do you invoke a superclass constructor? 


constructors and gc 


You might think that somewhere in, say, a Duck constructor, 
if Duck extends Animal you’d call Animal(). But that’s not 
how it works: 


public class Duck extends Animal { 
int size; 


砂 1 . 


public Duck(int newSize) { 

Animal () ; 4^ _ 


size = newSize 


^ i s 


hoi 1^1/ 


The only way to call a super constructor is by calling super(). 
That’s right — super() calls the super constructor. 

What are the odds? 

public class Duck extends Animal { 
int size; 


public Duck(int newSize) { 

super () ; <r- 

size = newSize; 



A call to super 。 in your constructor puts the superclass 
constructor on the top of the Stack. And what do you 
think that superclass constructor does? Calls its superclass 
constructor. And so it goes until the Object constructor is 
on the top of the Stack. Once Object0 finishes, it’s popped 
off the Stack and the next thing down the Stack (the 
subclass constructor that called Object()) is now on top. 
That constructor finishes and so it goes until the original 
constructor is on the top of the Stack, where it can now 
finish. 


And how is it that we J ve 
gotten away without 
doing it? 

You probably figured that out. 

Our good friend the compiler 
puts in a call to superf) if you 
don’t. 

So the compiler gets involved in 
constructor-making in two ways: 

① If you don’t provide a constructor 

The compiler puts one in that looks like: 

public ClassName() { 
super(); 


② If you do provide a constructor 
but you do not put in the call to 
super() 

The compiler will put a call to super。in 
each of your overloaded constructors * 
The compiler-supplied call looks like: 

super(); 

It always looks like that. The compiler- 
inserted call to superf) is always a no-arg 
call. If the superclass has overloaded 
constructors, only the no-arg one is called. 

★Unless the constructor calls another overloaded 
constructor (you’ll see that in a few pages). 
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object lifecycle 


Cah the child exist before 
the parents? 

If you think of a superclass as the parent to the subclass child, 
you can figure out which has to exist first. The superclass parts 
of an object have to be fully-formed (completely built) before the 
subclass parts can be constructed. Remember, 
the subclass object might depend on things it 
inherits from the superclass, so it’s important 
that those inherited things be finished. No 
way around it. The superclass constructor 
must finish before its subclass constructor. 


Look at the Stack series on page 248 again, 
and you can see that while the Hippo 
constructor is the first to be invoked (it’s 
the first thing on the Stack), it’s the last one 
to complete! Each subclass constructor 
immediately invokes its own superclass 
constructor, until the Object constructor 
is on the top of the Stack. Then Object’s 
constructor completes and we bounce 
back down the Stack to Animal’s 
constructor. Only after Animal’s constructor completes 
do we finally come back down to finish the rest of the Hippo 
constructor. For that reason: 

The call to super() must be the first statement 
in each constructor!* 



Possible constructors for class Boop 



[^[ public Boop () { 
super(); 

} 

防 public Boop(int i) { 
super(); 
size = i; 


ih h /Z ° K b ^us c 

s 鞠 


\^\ public Boop () { 


Th ( 


W\ public Boop(int i) { 


size 


i; f 


^ 4: r 4 


0 public Boop (int i) { BAD 


size 


super(); 





clsl^ C}r() tc,ow 


^ ^iV XFUi 


There’s an exception to this rule; you’ll learn it on page 252. 
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Superclass constructors with arguments 


What if the superclass constructor has arguments? Can you pass something in to 
the super() call? Of course. If you couldn’t ， you’d never be able to extend a class 
that didn’t have a no-arg constructor. Imagine this scenario: all animals have a 
name. There’s a getName() method in class Animal that returns the value of the 
name instance variable. The instance variable is marked private, but the subclass 
(in this case, Hippo) inherits the getName() method. So here’s the problem: 

Hippo has a getName() method (through inheritance), but does not have the name 
instance variable. Hippo has to depend on the Animal part of himself to keep the 
name instance variable, and return it when someone calls getName() on a Hippo 
object. But... how does the Animal part get the name? The only reference Hippo 
has to the Animal part of himself is through super(), so that’s the place where 
Hippo sends the Hippo’s name up to the Animal part of himself, so that the 
Animal part can store it in the private name instance variable. 


public abstract class Animal { 

private String name ; 心 - ^11 animals 

subclasses) a 


public String getName() 
return name; 




Animal 


private String name 


r-vi mi I lai^ou ■■ ly 11 ) 


on ii iy yeuNcmie^ 






public Animal(String theName) 
name = theName; * 


㉟之在 

liable 


The Animal part of 
me needs to know my name, 
so I take a name in my own 
Hippo constructor, then pass 
the name to super() 


public class Hippo extends Animal { 


public Hippo (String name) { , a 妁如亡 

super (naxne); ⑽如冰 


public class MakeHippo { 

public static void main(String[] args) 
Hippo h = new Hippo (' 、 Buffy”> ; ^ - 


System.out.println(h.getName()); 




File Edit Window Help Hide 


% java MakeHippo 
Buffy 
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Invoking one overloaded constructor 
from another 


What if you have overloaded constructors that, with 
the exception of handling different argument types, 
all do the same thing? You know that you don’t want 
duplicate code sitting in each of the constructors (pain 
to maintain, etc.), so you’d like to put the bulk of the 
constructor code (including the call to super()) in only 
one of the overloaded constructors. You want whichever 
constructor is first invoked to call The Real Constructor 
and let The Real Constructor finish the job of 
construction. It’s simple: just say this(). Or this(aString). 
Or this(2 7, x). In other words, just imagine that the 
keyword this is a reference to the current object 

You can say this() only within a constructor, and it must 
be the first statement in the constructor! 

But that’s a problem, isn’t it? Earlier we said that 
super () must be the first statement in the constructor. 
Well, that means you get a choice. 

Every constructor can have a call to super() 
or this()，but never both! 




\Jsc tWO to call a 

onsWor W another 

overloaded constructor in 

L e same class. 

U call to tWO 
can U used only ^ a 

tU fet Statement in a 
coftstructor. 

A constructor can Uvc < 

calltosuperOOUtWO, 

Ut never toth. 


can 


class Mini extends Car { 

Color color; 

public Mini() { 

this(Color.Red );< - 

} 

public Mini(Color c) { 

super (''Mini^ - 

color = c; 

// more initialization 


r d 

3 overloaded ^ 
tails s 吧 〆)). 


J hiS Rcal CohS-t^U^W ihai 


public Mini(int size) { 

this (Color. Red) ; ; 

super (size) ; l 令 赠 k!! Ca^i have 




File Edit Window Help Drive 


javac Mini.java 


Mini.java:16: call to 

super must 

be first statement in 

constructor 

super (); 


A 
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Some of the constructors in the SonOfBoo class will not 
compile. See if you can recognize which constructors are 
not legal. Match the compiler errors with the SonOfBoo 
constructors that caused them, by drawing a line from the 
compiler error to the "bad” constructor. 

public class Boo { 

public Boo(int i) { } 
public Boo(String s) { } 
public Boo(String s, int i) { } 


class SonOfBoo extends Boo { 

public SonOfBoo() { 
super (''boo"); 

} 

public SonOfBoo(int i) { 
super (''Fred"); 


^9ss 


is 










Roses are red . - / 

: h S bef 〜 


% javac SonOfBoo.java 
cannot resolve symbol 

symbol : constructor Boo 
(java•lang.String,java.la 
ng.String) 


public SonOfBoo(String s) { 
super(42); 


public SonOfBoo(int i. String s) { 


public SonOfBoo(String a. String b. String c) { 
super(a,b); 

} 

public SonOfBoo(int i, int j) { 
super (''man", j); 

} 

public SonOfBoo(int i, int x, int y) { 
super (i, ''star"); 


File Edit Window Help Yadayadayada 


% javac SonOfBoo.java 

cannot resolve symbol 

symbol : constructor Boo 
(int,java.lang.String) 


File Edit Window Help ImNotListening 


% javac SonOfBoo.java 
cannot resolve symbol 
symbol : constructor Boo() 
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Now wc know how an object is born, 
but how long does m object live 飞 


An object’s life depends entirely on the life of references 
referring to it. If the reference is considered “alive”，the 
object is still alive on the Heap. If the reference dies 
(and we’ll look at what that means in just a moment), the 
object will die. 

So if an object’s life depends on the reference 
variable’s life, how long does a variable live? 

That depends on whether the variable is a local variable 
or an instance variable. The code below shows the life of a 
local variable. In the example, the variable is a primitive, 
but variable lifetime is the same whether it’s a primitive 
or reference variable. 

public class TestLifeOne { 


public void read() { 

int s = 42; ( _ _ s j s 

sleep(); 




public void sleep() { 

e ^ • 

} (、: 从 '— & 


㈣ 

s 





娜 0 


Ac 
^dO 

sh，h 3 ^ di 


① A local variable lives only 
within the method that 
declared the variable. 

public void read() { 

int s = 42; 

// 、 s A can be used only 
// within this method. 

// When this method ends, 

// 's' disappears completely. 

} 

Variable Yean be used only within the 
read() method. In other words, the variable 
is in scope only within its own method. No 
other code in the class (or any other class) 
can see's’. 


② An instance,variable lives 
as long as the object 
does. If the object is still 
alive, so are its instance 
variables. 

public class Life { 
int size; 

public void setSize(int s) { 
size = s; 

// 、 s f disappears at the 
// end of this method, 

// but 、 size f can be used 
// anywhere in the class 


Variable Y (this time a method parameter) 
is in scope only within the setSizeO 
method. But instance variable size is 
scoped to the life of the object as opposed 
to the life of the method. 
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The difference between life and 
scope for local variables: 


Life 

A local variable is alive as long as its Stack 
frame is on the Stack. In other words, 
until the method completes. 

Scope 

A local variable is in scope only within the 
method in which the variable was declared. 
When its own method calls another, the 
variable is alive, but not in scope until its 
method resumes. You can use a variable only 
when it is in scope. 


public void doStuff() { 
boolean b = true; 
go(4); 

} 

public void go(int x) { 
int z = x + 2 4; 
crazy(); 

// imagine more code here 

} 

public void crazy() { 

char c = 'a A ; 



doStufff) goes on the 
Stack. Variable ‘b’ is 
alive and in scope. 



go() plops on top of 
the Stack. ‘X’ and ‘z’ 


are alive and in scope, 
and y is alive but not 


in scope. 


crazyf) is pushed onto 
the Stack，with ‘c’ now 
alive and in scope. The 
other three variables 
are alive but out of 
scope. 


While a local variable is alive, its state persists. 

As long as method doStuff() is on the Stack, for 
example, the ‘b’ variable keeps its value. But the 
‘b’ variable can be used only while doStuff()’s 
Stack frame is at the top. In other words, you can 
use a local variable only while that local variable’s 
method is actually running (as opposed to 
waiting for higher Stack frames to complete). 


crazyf) completes and 
is popped off the Stack, 
so ‘c’ is out of scope 
and dead. When go() 
resumes where it left 
off, *x 5 and ( z J are both 
alive and back in scope. 
Variable ‘b’ is still alive 
but out of scope (until 
go() completes). 
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What about reference variables? 


The rules are the same for primtives and references. A reference 
variable can be used only when it’s in scope, which means you can’t use 
an object’s remote control unless you’ve got a reference variable that’s 
in scope. The real question is, 

“How does variable life affect object life?” 

An object is alive as long as there are live references to it. If a reference 
variable goes out of scope but is still alive, the object it refers to is still 
alive on the Heap. And then you have to ask... “What happens when the 
Stack frame holding the reference gets popped off the Stack at the end 
of the method?” 

If that was the only live reference to the object, the object is now 
abandoned on the Heap. The reference variable disintegrated with 
the Stack frame, so the abandoned object is now, officially, toast. The 
trick is to know the point at which an object becomes eligible for garbage 
collection. 


An objects life has no 
value, no meaning, no 
point, unless somebody 
has a reference to it. 

If you can’t get to it, 
you can’t ask it to do 
anything and it’s just a 
big fat waste of bits. 

But if an object is 
unreachable, the 


Once an object is eligible for garbage collection (GC), you don’t have 
to worry about reclaiming the memory that object was using. If your 
program gets low on memory, GC will destroy some or all of the eligible 
objects, to keep you from running out of RAM. You can still run out of 
memory, but not before all eligible objects have been hai 1 
dump. Your job is to make sure that you abandon object; 
them eligible for GC) when you’re done with them, so tl: 
collector has something to reclaim. If you hang on to ob 
help you and you run the risk of your program dying a p 
out-of-memory death. 


Garbage Collector will 
figure that out. Sooner 
or later，that object’s 
goin 9 down. 



An object becomes 
eligible for GC when 
its last live reference 
disappears. 


Three ways to get rid of an object’s reference: 


(T) The reference goes out of scope, permanently ^ 

void go() { 2 - 3 

Life z = new Life () ;^ 

( 5 ) The reference is assigned another object . 

Life z = new Life(); 〆 从 c 七 ? 汶七 0 

z = new Life() ; ^' s " 

a ^ 抑认 ’ 

(§) The reference is explicitly set to null 

Life z = new Life() ; °k ' 

/ 加 。 Y ^ 


z = null 
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Object-kil 


Reference s 
out of scop< 
permanentl 



public class StackRef { 
public void foof() { 
barf(); 


public void barf() { 

Duck d = new Duck(); 


foof() is pushed onto the 
Stack, no variables are 
declared. 




barf() is pushed onto the 
Stack, where it declares 
a reference variable, and 
creates a new object as¬ 
signed to that reference. 
The object is created on 
the Heap, and the refer¬ 
ence is alive and in scope. 




丁一 r 二 :: “ o 

㈣ ， avvA v A ， 

■、 s so 




barf() completes and pops 
off the Stack. Its frame 
disintegrates, so ( d J is now 
dead and gone. Execution 
returns to foof(), but foof() 
can’t use ‘d’ ■ 




Uh—oh. Thevd\ridb!e 
w ⑶七 away the bav-fO 
S*tcl^k -fvcIr^C wds blowh 

the sta^k, so the Du^k 
is dbdhdohed. ^d\rbc)^e— 
Co\\tt{,oY bait 
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Object-killer 


Assign the refe 
to another obje 

public class ReRef { 

Duck d = new Duck(); 

public void go() { 
d = new Duck(); 



Dude, all you 
had to do was reset 
the reference. Guess 
they didiVt have memory 
management back then. 



Jf cvewt 


UcV^k 9 ocs o, -tKe rescued 
b 7 Srntc ^ «s variable, the 

Putk y/«ll IWc as lo^ as tKc RcRcf okjet 七 
払 a 七 msla^iatcd \i is alive. Unless... 


assi^cd a Putk okjeti Icavm^Kc 

Putk ok^-t abated. TV^at 

^\ rs i putk »s ^ as ^ood as dead. 
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Object-killer 

Explicitly set tl 
reference to vu 



public class ReRef { 

Duck d = new Duck(); 

public void go() { 
d = null; 


The meaning of null 

When you set a reference to null, you’re 
deprogramming the remote control. 

In other words,you’ve got a remote 
control, but no TV at the other end. A null 
reference has bits representing 'null' (we 
don’t know or care what those bits are, as 
long as the JVM knows). 

If you have an unprogrammed remote 
control, in the real world, the buttons don’t 
do anything when you press them. But 
in Java, you can’t press the buttons (i.e. 
use the dot operator) on a null reference, 
because the JVM knows (this is a runtime 
issue, not a compiler error) that you're 
expecting a bark but there’s no Dog there 
to do it! 

If you use the dot operator on 
a null reference, you’ll get a 
NullPointerException at runtime. You'll 
learn all about Exceptions in the Risky 
Behavior chapter. 



⑽ putk 3 0CS oy. tKc Heap, 
by V. S'mtc "A" vanaklc, 

Putk Will IWc as lo^ as tKc okjc 乙七 

払 a 七 mslaAaW it is ak. Unless... 


/ T :。 口:二丄 


■to 妁认 \\. 



dSs S C Uo W* 中七 1 如 3 , 

▲I 栋 U ? 呼_以 to 弋代;。七 

⑽ allowed to use tKc dot oy, d »ts 

re^o^dvnvned (assi^cd ^ object). 
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Fireside Chats 



Tonight’s Talk ： An instance variable and 
a local variable discuss life and death 
(with remarkable civility) 


Instance Variable 

I’d like to go first，because I tend to be more 
important to a program than a local variable. 
I’m there to support an object, usually 
throughout the object’s entire life. After all, 
what’s an object without state? And what is 
state? Values kept in instance variables. 


No, don’t get me wrong, I do understand your 
role in a method, it’s just that your life is so 
short. So temporary. That’s why they call you 
guys “temporary variables”. 

My apologies. I understand completely. 


I never really thought about it like that. What 
are you doing while the other methods are 
running and you’re waiting for your frame to 
be the top of the Stack again? 


Local Variable 


I appreciate your point of view, and I certainly 
appreciate the value of object state and all, 
but I don’t want folks to be misled. Local 
variables are really important. To use your 
phrase, “After all, what’s an object without 
behavior}’’ And what is behavior? Algorithms 
in methods. And you can bet your bits there’ll 
be some local variables in there to make those 
algorithms work. 

Within the local-variable community, the 
phrase “temporary variable” is considered 
derogatory. We prefer “local” ， “stack” ， “auto- 
matic”，or ” Scope-challenged”. 

Anyway, it’s true that we don’t have a long 
life, and it’s not a particularly good life either. 
First, we’re shoved into a Stack frame with 
all the other local variables. And then, if the 
method we’re part of calls another method, 
another frame is pushed on top of us. And if 
that method calls another method... and so on. 
Sometimes we have to wait forever for all the 
other methods on top of the Stack to com¬ 
plete so that our method can run again. 

Nothing. Nothing at all. It’s like being in 
stasis — that thing they do to people in science 
fiction movies when they have to travel long 
distances. Suspended animation, really. We 
just sit there on hold. As long as our frame is 
still there, we’re safe and the value we hold 
is secure, but it’s a mixed blessing when our 
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Instance Variable 


We saw an educational video about it once. 
Looks like a pretty brutal ending. I mean, 
when that method hits its ending curly brace, 
the frame is literally blown off the Stack! Now 
that’s gotta hurt. 


I live on the Heap, with the objects. Well, not 
with the objects, actually in an object. The 
object whose state I store. I have to admit life 
can be pretty luxurious on the Heap. A lot of 
us feel guilty, especially around the holidays. 


OK, hypothetically, yes, if I’m an instance 
variable of the Collar and the Collar gets 
GC’d, then the Collar’s instance variables 
would indeed be tossed out like so many pizza 
boxes. But I was told that this almost never 
happens. 


They let us drink? 


Local Variable 

frame gets to run again. On the one hand, we 
get to be active again. On the other hand, the 
clock starts ticking again on our short lives. 
The more time our method spends running, 
the closer we get to the end of the method. 

We all know what happens then. 

Tell me about it. In computer science they use 
the term popped as in “the frame was popped 
off the Stack”. That makes it sound fun, or 
maybe like an extreme sport. But, well, you 
saw the footage. So why don’t we talk about 
you? I know what my little Stack frame looks 
like, but where do you live? 


But you don’t always live as long as the object 
who declared you, right? Say there’s a Dog 
object with a Collar instance variable. Imagine 
you re an instance variable of the Collar object, 
maybe a reference to a Buckle or something, 
sitting there all happy inside the Collar object 
who’s all happy inside the .Dog'object. But... 
what happens if the Dog wants a new Collar, 
or nulls out its Collar instance variable? That 
makes the Collar object eligible for GC. So... 
if you re an instance variable inside the Collar, 
and the whole Collar is abandoned, what 
happens to you? 


And you believed it? That’s what they say to 
keep us motivated and productive. But aren’t 
you forgetting something else? What if you’re 
an instance variable inside an object, and that 
object is referenced only by a /oca/variable? If 
I’m the only reference to the object you’re in, 
when I go, you’re coming with me. Like it or 
not, our fates may be connected. So I say we 
forget about all this and go get drunk while 
we still can. Carpe RAM and all that. 
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BE 如 Garbage Collector 

\^iicli of the lines of code on the if added 
to the class on the left at point A ， would cause 
exactly one additional object to be eligible for the 
Garbage Collector? (Assume that point A (//call 
more meSiods) will execute for a long time, giving tke 
Garbage Collector time to do its Stuff.) 



public class GC { 

public static GC doStuff() { 

GC newGC = new GC(); 
doStuff2(newGC); 
return newGC; 

} 

public static void main(String [] args) { 

GC gel; 

GC gc2 = new GC (); 

GC gc3 = new GC(); 

GC gc4 = gc3; 
gel = doStuff(); 

❹ 

// call more methods 

} 

public static void doStuff2(GC copyGC) { 
GC localGC 


copyGC = null; 


2 gc2 = null; 


newGC 


=gc3 ; 


4 gel = null; 


5 newGC = null; 


6 gc4 = null; 


8 

9 


gc3 = 

=gc2 ; 

gel = 

: gc4 ; 

gc3 = 

=null; 
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P 


class Bees { 

Honey [] beeHA; 

} 

class Raccoon { 
Kit k; 

Honey rh; 


In this code example, several new objects are created. 
Your challenge is to find the object that is 'most popular’, 
i.e.the one that has the most reference variables referring 
to it. Then list how many total references there are for 
that object, and what they are! We’ll start by pointing out 
one of the new objects, and its reference variable. 

Good Luck! 



class Kit { 
Honey kh; 


class Bear { 
Honey hunny; 


public class Honey { 

public static void main(String [] args) { 

Honey honeyPot = new Honey(); 

Honey [] ha = {honeyPot, honeyPot, honeyPot, honeyPot}; 
Bees bl = new Bees(); 
bl.beeHA = ha; 


Bear [] ba = new Bear[5]; 
for (int x=0; x < 5; x++) { 
ba[x] = new Bear(); 


ba[x].hunny = honeyPot; 


Kit k = new Kit(); 
k.kh = honeyPot; 

Raccoon r = new Raccoon() 



r.rh = honeyPot; 
r. k = k; 



Here*s a new 
Raccoon object! 


Here's its reference 
variable V. 


k = null; 

} // end of main 
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pye 趙 _e 
Mystery 


“We’ve run the simulation four times, and the main module’s temperature consistently 
drifts out of nominal towards cold”，Sarah said, exasperated. “We installed the new temp-bots last 
week. The readings on the radiator bots, designed to cool the living quarters, seem to be within 
spec, so we’ve focused our analysis on the heat retention bots, the bots that help to warm the quar¬ 
ters.^ Tom sighed, at first it had seemed that nano-technology was going to really put them ahead 
of schedule. Now, with only five weeks left until launch, some of the orbiter’s key life support 
systems were still not passing the simulation gauntlet. 

“What ratios are you simulating?’’，Tom asked. 

“Well if I see where you’re going, we already thought of that’’，Sarah replied. “Mis- 



sion control will not sign off on critical systems if we run them out of spec. We are 
required to run the v3 radiator bot’s SimUnits in a 2:1 ratio with the v2 radiator’s 
SimUnits”，Sarah continued. “Overall，the ratio of retention bots to radiator bots is 
supposed to run 4:3.” 

“How’s power consumption Sarah?’’，Tom asked. Sarah paused, “Well that’s 
another thing, power consumption is running higher than anticipated. We’ve got a team 
tracking that down too, but because the nanos are wireless it’s been hard to isolate the power 


consumption of the radiators from the retention bots.” “Overall power consumption ratios”，Sarah 
continued, “are designed to run 3:2 with the radiators pulling more power from the wireless grid.” 


“OK Sarah’’，Tom said “Let’s take a look at some of the simulation initiation code. 
WeVe got to find this problem, and find it quick!” 


import java.util.*; 
class V2Radiator { 

V2Radiator(ArrayList list) { 
for(int x=0; x<5; x++) { 

list. add (new SimUnit ( "V2Radiator ’’））； 


class V3Radiator extends V2Radiator { 
V3Radiator(ArrayList lglist) { 
super(lglist); 
for(int g=0; g<10; g++) { 

lglist. add(new SimUnit( "V3Radiator ’’））； 


class RetentionBot { 

RetentionBot(ArrayList rlist) { 

rlist.add(new SimUnit("Retention ”））； 
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Five 趙 
_tery 
confirmed ••• 


public class TestLifeSupportSim { 

public static void main(String [] args) { 
ArrayList aList = new ArrayList(); 

V2Radiator v2 = new V2Radiator(aList); 
V3Radiator v3 = new V3Radiator(aList); 
for(int z=0; z<20; z++) { 

RetentionBot ret = new RetentionBot(aList); 


class SimUnit { 

String botType; 

SimUnit(String type) { 
botType = type; 

} 

int powerUse() { 

if ("Retention”.equals(botType)) { 
return 2; 

} else { 
return 4; 


Tom gave the code a quick look and a small smile creeped across his lips. I think I’ve 
found the problem Sarah, and I bet I know by what percentage your power usage readings are off 
too! 


What did Tom suspect? How could he guess the power readings errors, and what few 
lines of code could you add to help debug this program? 
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Exercise Solutions 



1 

copyGC = null; 

No - this line attempts to access a variable 




that is out of scope. 

2 

gc2 — 

null; 

OK - gc2 was the only reference variable 




referring to that object. 

3 

newGC 

=gc3 ; 

No - another out of scope variable. 

4 

gel — 

null; 

OK - gel had the only reference because 




newGC is out of scope. 

5 

newGC 

— null; 

No - newSC is out of scope. 

6 

gc4 = 

null; 

No - gc3 is still referring to that object. 

7 

gc3 — 

gc2 ; 

No - gc4 is still referring to that object. 

8 

gel — 

gc4 ; 

OK - Reassigning the only reference to 




that object. 

9 

gc3 二 

null; 

No - gc4 is still referring to that object. 



It probably wasn't too hard to figure out that the Honey object first referred to by the honeyPot variable is by 
far the most'popular’object in this class. But maybe it was a little trickier to see that all of the variables that 
point from the code to the Honey object refer to the same object] There area total of 12 active references to 
this object right before the main() method completes. The k.kh variable is valid for a while, but k gets nulled 
at the end. Since r.k still refers to the Kit object, r.k.kh (although never explicity declared), refers to the object! 




public class Honey { 

public static void main(String [] args) 

- Honey honeyPot = new Honey(); 

- Honey [] ha = {honeyPot, honeyPot, 

honeyPot, honeyPot}; 
Bees bl = new Bees(); 

- bl.beeHA = ha; 

Bear [] ba = new Bear[5]; 
for (int x=0; x < 5; x++) { 

- ba[x] = new Bear(); 

ba[x].hunny = honeyPot; 

Undsup null)_ ^ it k = new Kit(); 

I k.kh = honeyPot; 

Raccoon r = new Raccoon(); 


{ 


r.rh = honeyPot; 
r.k = k; 

k = null; 

// end of main 
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constructors and gc 



Fiye^lnute JVtysfery S^lutkn 

Tom noticed that the constructor for the V2Radiator class took an 
Array List. That meant that every time the VJRadiator constructor was called, 
it passed an ArrayList in its super() call to the V2Radiator constructor. That 
meant that an extra five V2Radiator SimUnits were created. If Tom was right, 
total power use would have been 120, not the 100 that Sarah’s expected ratios 
predicted. 

Since all the Bot classes create SimUnits, writing a constructor for 
the SimUnit class, that printed out a line everytime a SimUnit was created, 
would have quickly highlighted the problem! 
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Numbers Matter 



Do the Math. But there’s more to working with numbers than just doing primitive 
arithmetic. You might want to get the absolute value of a number, or round a number, or find 
the larger of two numbers. You might want your numbers to print with exactly two decimal 
places, or you might want to put commas into your large numbers to make them easier to read. 
And what about working with dates? You might want to print dates in a variety of ways, or even 
manipulate dates to say things like,"add three weeks to today’s date ’： And what about parsing 
a String into a number? Or turning a number into a String? You’re in luck.The Java API is full of 
handy number-tweaking methods ready and easy to use. But most of them are static, so we’ll 
start by learning what it means for a variable or method to be static, including constants in 
Java — static f/'na/variables. 
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Math methods 


MATH methods: as close as you'll 
ever get to a global method 


Except there’s no global anything in Java. But think about 
this: what if you have a method whose behavior doesn’t 
depend on an instance variable value. Take the round() 
method in the Math class, for example. It does the same 
thing every time — rounds a floating point number (the 
argument to the method) to the nearest integer. Every 
time. If you had 10,000 instances of class Math, and ran 
the round(42.2) method, you’d get an integer value of 
42. Every time. In other words, the method acts on the 
argument, but is never affected by an instance variable 
state. The only value that changes the way the round() 
method runs is the argument passed to the method! 

Doesn’t it seem like a waste of perfectly good heap space 
to make an instance of class Math simply to run the 
round () method? And what about other Math methods 
like min(), which takes two numerical primitives and 
returns the smaller of the two. Or max(). Or abs(), which 
returns the absolute value of a number. 

These methods never use instance variable values. In fact the 
Math class doesn’t have any instance variables. So there’s 
nothing to be gained by making an instance of class 
Math. So guess what? You don’t have to. As a matter of 
fact, you can’t. 

If you try to make an instance of 
class Math: 

Math mathObject = new Math(); 

You’ll get this error: 


Mediocb in Ae Math class 
don’t use any instance 
variable values. because 
Ae mefliods are ‘static ’， 

’t need to have an 

__ of MaA. All You 

need is Ae Math class. 


you don’l 
instance 


int x = Math.round(42.2); 
int y = Math.min(56,12); 
int z = Math.abs(-343); 


hcvcv- use 

bchav,ov doesh i 

khOW abo 心平“心 obj^i 


File Edit Window Help IwasToldThereWouldBeNoMath 


% javac TestMath 

TestMath.java : 3 : Math() has private 
access in j ava.lang.Math 

Math mathObject = new Math(); 

A 

1 error 


kyhis shows ^七从 


274 





numbers and statics 


The difference between regular 
(wow-static) and static methods 

Java is object-oriented，but once in a while you have a special case, 
typically a utility method (like the Math methods), where there is 
no need to have an instance of the class. The keyword static lets 
a method run without any instance of the class. A static method means 
“behavior not dependent on an instance variable, so no instance/object 
is required. Just the class.” 


regular (non-static) method 

public class Song { 

String title; ^ 

public Song (String 
title = t; 

} 

public void play() { 

SoundPlayer player = new SoundPlayer(); 
player.playSound(title); 

㉟ 以 W. 









Song 
s2.play(); 




Song 

s3.play(); 

/ 

Callm 3 playO oh this 

will da* 

Wy ’ 七。 play. 


static method 


public static int min(int a, int b){ 


//returns the lesser of a and b 



Ko vahaWes. 

TV,e wtW 

vanaW. state. 


Math.min(42,36); 




Use 

d rt 

y\awC 


於 〆, w 伽 

vanaWc 



objects" 


you are here ► 275 
















static methods 


Call a static method 
Class name 、 



Math 


.min 


using a 


( 88 , 86 ); 


Call a non-static method using a 

reference variable name 



Song t2 = new Song(); 
t2•play(); 


What it means to have a 
class with static methods. 


Often (although not always), a class with static 
methods is not meant to be instantiated. In Chapter 
8 we talked about abstract classes, and how marking 
a class with the abstract modifier makes it 
impossible for anyone to say ‘new’ on that class type. 
In other words, it’s impossible to instantiate an abstract 
class. 

But you can restrict other code from instantiating 
a non-abstract class by marking the constructor 
private. Remember, a method marked private means 
that only code from within the class can invoke 
the method. A constructor marked private means 
essentially the same thing — only code from within 
the class can invoke the constructor. Nobody can 
say ‘new’ from outside the class. That’s how it works 
with the Math class, for example. The constructor 
is private, you cannot make a new instance of Math. 
The compiler knows that your code doesn’t have 
access to that private constructor. 


This does not mean that a class with one or more 
static methods should never be instantiated. In fact, 
every class you put a main() method in is a class with 
a static method in it! 

Typically, you make a main() method so that you 
can launch or test another class, nearly always by 
instantiating a class in main, and then invoking a 
method on that new instance. 

So you’re free to combine static and non-static 
methods in a class, although even a single non-static 
method means there must be some way to make an 
instance of the class. The only ways to get a new 
object are through ‘new’ or deserialization (or 
something called the Java Reflection API that we 
don’t go into). No other way. But exactly who says new 
can be an interesting question, and one we’ll look at 
a little later in this chapter. 
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Static methods caw't use wow-static 
(instance) variables! 


Static methods run without knowing about any particular 
instance of the static method’s class. And as you saw on 
the previous pages, there might not even be any instances 
of that class. Since a static method is called using the class 
(Ma^.random()) as opposed to an instance reference (^2.play()), 
a static method can’t refer to any instance variables of the 
class. The static method doesn’t know which instance’s variable 
value to use. 


If you try to compile this code: 


public class Duck { 
private int size; 



public static void main (String[] args) { 
System, out .println (''Size of duck is '' 


size 


public void setSize(int s) { 
size = s; 


[{ 处一 S a Dwik o h 

e 


If you try to use an 
instance variable from 
inside a static mediod, 


Ae compiler Ainks, 

“I don't tnow winch 
object’s instance variable 
you’re talking about!” 

If you have ten Duct 
objects on the he 迚 ， a 



mediod doesn’t 
about any of them. 


public int getSize() { 

return size; 


You’ll get this error: 


File Edit Window Help Quack 


% javac Duck.java 

Duck.java:6: non - static variable 
size cannot be referenced from a 
static context 

System. out. println (''Size 
of duck is '' + size); 

A 


rm sure they're 
talking about MY 
size variable. 


No, rm pretty sure 
they re talking about 
MY size variable. 
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static methods 


Static methods caw't use wow-static 
methods, either! 


What do non-static methods do? They usually use instance 
variable state to affect the behavior of the method. A getName() 
method returns the value of the name variable. Whose name? 
The object used to invoke the getName() method. 


This won’t compile: 


public class Duck 


• 切 V^bli 


private int size; 

public static void main (String[] args) { 

System, out .println (''Size is '' + getSize ()); 



public void setSize(int s) { 


size = s; 


public int getSize()( 
return size; 


☆ t。 …〆 


oWw. 


File Edit Window Help Jack-in 


% javac Duck.java 

Duck.java:6: non-static method 
getSize() cannot be referenced 
from a static context 


System. out.println(''Size 
of duck is '' + gets 


Java 


Make ^ 汸 6 卜 

Roses are red, 

an d known to bloom Lte 

Statics can't see 


fjiereiare^np o 

Dumb Questions 


What if you try to call a non-static 
method from a static method, but the 
non-static method doesn’t use any in¬ 
stance variables. Will the compiler allow 
that? 


No.The compiler knows that 
whether you do or do not use instance 
variables in a non-static method,you can. 
And think about the implications... if you 
were allowed to compile a scenario like 
that, then what happens if in the future 
you want to change the implementation 
of that non-static method so that one day 
it does use an instance variable? Or worse, 
what happens if a subclass overrides the 
method and uses an instance variable in 
the overriding version? 

I could swear I’ve seen code that 
calls a static method using a reference 
variable instead of the class name. 


You con do that, but as your mother 
always told you,"Just because it’s legal 
doesn’t mean it’s good.” Although it works 
to call a static method using any instance 
of the class, it makes for misleading (less- 
readable) code. You can say. 

Duck d = new Duck(); 

String[] s = {}; 
d.main(s); 


This code is legal, but the compiler just 
resolves it back to the real class anyway 
("OK, d is of type Duck, and main() is static, 
so HI call the static main() in class Duck”). 
In other words, using d to invoke main() 
doesn’t imply that main() will have any 
special knowledge of the object that d is 
referencing. It’s just an alternate way to 
invoke a static method, but the method is 
still static! 


278 


chapter 10 




numbers and statics 


Static variable: 

value is the same for ALL 
instances of the class 

Imagine you wanted to count how many Duck 
instances are being created while your program is 
running. How would you do it? Maybe an instance 
variable that you increment in the constructor? 

class Duck { 

int duckCount = 0; 
public Duck() { 

duckCount++; ii . 

No, that wouldn’t work because duckCount is an 
instance variable, and starts at 0 for each Duck. You 
could try calling a method in some other class, but 
that’s kludgey. You need a class that’s got only a single 
copy of the variable, and all instances share that one 
copy. 

That’s what a static variable gives you: a value shared 
by all instances of a class. In other words, one value 
per class, instead of one value per instance. 


public class Duck { 


private int size; 



㉗ 讀 

S 上以义 



private static int duckCount = 0; 


public Duck() { 

duckCount++ 

} 


卜 I “ill k ecp 

duckets 

〜 n e c ; : 

public void setSize(int s) { 


size = s; 


public int getSize() { 
return size; 


size ： 

duckCo 



^C/f 


Duck 

size 

static duckC 

TV / 

ountf 

’ getSize() 
setSize() 



# 。一 
恥 〆 ^ ^ i ^ y 






ze ： 22 
uckCount ： 4 




slze: 8 
duckCount ： 4 








oy\c 


㈣ 
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static variables 



k\d msta 以 。 M 


variable ： kid ihsta^c 七 w 


Static variatles are stared* 


AU instances oi tke same 
class stare a single copy ol 
tke static variables. 

instance variables ： 1 per instance 
static variables ： 1 per class 


^ Brain Barbell 


Earlier in this chapter, we saw that a private 
constructor means that the class can’t be instantiated 
from code running outside the class. In other words, 
only code from within the class can make a new 
instance of a class with a private constructor. (There’s 
a kind of chicken-and-egg problem here.) 


What if you want to write a class in such a way that 
only ONE instance of it can be created, and anyone 
who wants to use an instance of the class will always 
use that one, single instance? 
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numbers and statics 


Static variables are initialized when a class is loaded. A class is 
loaded because the JVM decides it’s time to load it. Typically, 
the JVM loads a class because somebody’s trying to make a 
new instance of the class, for the first time, or use a static 
method or variable of the class. As a programmer, you also 
have the option of telling the JVM to load a class, but you’re 
not likely to need to do that. In nearly all cases, you’re better 
off letting the JVM decide when to load the class. 

And there are two guarantees about static initialization: 

Static variables in a class are initialized before any object of that 
class can be created. 

Static variables in a class are initialized before any static method 
of the class runs. 

class Player { 

static int playerCount = 0; 

private String name; 

public Player(String n) { 

name = n; 

playerCount++; 


public class PlayerTestDrive { 

public static void main(String[] 

System.out.println(Player.pi 
Player one = new Player (''Tiger Woods"); 

System.out.println(Player.playerCount); 

} ' hutss a siahc variable just l«kc a 

} -tKc tlass aw. 


Static variables are initialized when the class is loaded. If you 
don’t explicitly initialize a static variable (by assigning it a 
value at the time you declare it) ， it gets a default value, so int 
variables are initialized to zero, which means we didn’t need 
to explicitly say “playerCount = 0”. Declaring, but not initial¬ 
izing, a static variable means the static variable will get the de¬ 
fault value for that variable type, in exactly the same way that 
instance variables are given default values when declared. 


I File Edit Window Help What? 


% java PlayerTestDrive 
◦ ^^ bc-Pov-c ar>y mstawes av-c made 



args) { 
ayerCount) 


Tk plavcrCou^ -.s m • 七 al— ▲个 d . asss 

t!f b ; e d s ^ ^^6 

P^iiive pomis ^ doubw ^ 

DOoICcih* Tellsc 

objat hU ll 

w 


All static variables 
in a class are 
initialized before 
any object of 
that class can be 
created. 
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static fina l variables are constants 

A variable marked finalmeans that — once initialized — it can 
never change. In other words, the value of the static final variable 
will stay the same as long as the class is loaded. Look up Math.PI 
in the API, and you’ll find: 

public static final double PI = 3.141592653589793 ; 

The variable is marked public so that any code can access it. 

The variable is marked static so that you don’t need an 
instance of class Math (which, remember, you’re not allowed to 
create). 

The variable is marked final because PI doesn’t change (as far as 
Java is concerned). 

There is no other way to designate a variable as a constant, but 
there is a naming convention that helps you to recognize one. 

Constant variable names should be in all caps! 



is a block 
of code that runs when a 
class is loaded, before any 
other code can use the 
class, so it’s a great place 
to initialize a static final 
variable. 

class Foo { 

final static int x 
static { 
x = 42; 

} 



Initialize a final static variable: 

① At the time you declare it ： 


public class Foo { 

public static final int FOO—X 

t Cfb!' 3£o ^iior, ^ 


25 


② In a static initializer 


public class Bar { 

public static final double BAR SIGN 



static 


BAR SIGN = (double) Math.random() 


c ^ be used y 屯 iit 


If you don't give a value to a final variable 
in one of those two places ： 

public class Bar { 

public static final double BAR—SIGN; 

} ^ 叫，/ 


The compiler will catch it ： 


■File Edit Window Help Jack-in j 


% javac Bar.java 

Bar.java:1: variable BAR—SIGN 
might not have been initialized 

1 error 
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final isn't just for static 
variables... 


You can use the keyword final to modify non¬ 
static variables too, including instance variables, 
local variables, and even method parameters. In 
each case, it means the same thing: the value can’t 
be changed. But you can also use final to stop 
someone from overriding a method or making a 
subclass. 


non-static final variables 


class Foof { 

final int size = 


3 r 


final int whuffie; 


Foof () { pp. 

whuffie = 42 ; y\oy/ you 乙 a 妁’七 

} 

void doStuff (final int x) { 

// you can't change x 

} 

void doMore() { 

final int z = 7 ; 

// you can't change z 


final method 

class Poof { 

final void calcWhuffie () { 

// important things 

// that must never be overridden 


final Class 

final class MyMostPerfectClass { 
// cannot be extended 


A iinal variable means you 
can’t ckange its value* 


A iinal metlioct means you 
can’t overricte tke metliocL 


A iinal class means you 
can’t extent! tke class (i.e. 
you can^t make a subclass)* 
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^JiereiEirejio 

Dumb Questions 


A static method can’t access a 
non-static variable. But can a non-static 
method access a static variable? 


A ： 


Of course. A non-static method in a 


class can always call a static method in the 
class or access a static variable of the class. 


Why would I want to make a class 
final? Doesn’t that defeat the whole 
purpose of 00? 

A- 

Jr \ m Yes and no. A typical reason for 
making a class final is for security. You 
can’t, for example, make a subclass of the 
String class. Imagine the havoc if someone 
extended the String class and substituted 
their own String subclass objects, 
polymorphically, where String objects 
are expected. If you need to count on a 
particular implementation of the methods 
in a class, make the class final. 


Isn’t it redundant to have to mark 
the methods final if the class is final? 

A. 

厂 Y- If the class is final, you don’t need to 
mark the methods final.Think about it — if 
a class is final it can never be subclassed, 
so none of the methods can ever be 
overridden. 

On the other hand, if you do want to allow 
others to extend your class, and you want 
them to be able to override some, but not 
all, of the methods, then don’t mark the 
class final but go in and selectively mark 
specific methods as final. A final method 
means that a subclass can’t override that 
particular method. 


_BULLET POINTS _ 

■ A static method should be called using the class 
name rather than an object reference variable: 

Math. random () vs. myFoo. go () 

■ A static method can be invoked without any instances 
of the method’s class on the heap. 

■ A static method is good for a utility method that does 
not (and will never) depend on a particular instance 
variable value. 

■ A static method is not associated with a particular 
instance—only the class—so it cannot access any 
instance variable values of its class. It wouldn't know 
which instance’s values to use. 

■ A static method cannot access a non-static method, 
since non-static methods are usually associated with 
instance variable state. 

■ If you have a class with only static methods, and you 
do not want the class to be instantiated, you can mark 
the constructor private. 

■ A static variable is a variable shared by all members 
of a given class. There is only one copy of a static 
variable in a class, rather than one copy per each 
individual instance for instance variables. 

■ A static method can access a static variable. 

■ To make a constant in Java, mark a variable as both 
static and final. 

■ A final static variable must be assigned a value either 
at the time it is declared, or in a static initializer. 

static { 

DOG 一 CODE = 420; 

} 一 

■ The naming convention for constants (final static 
variables) is to make the name all uppercase. 

■ A final variable value cannot be changed once it has 
been assigned. 

■ Assigning a value to a final instance variable must be 
either at the time it is declared, or in the constructor. 

■ A final method cannot be overridden. 

■ A final class cannot be extended (subclassed). 
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f^^rpen your pencil 


What’s Legal? 

Given everything you’ve just 
learned about static and final, 
which of these would compile? 


KEEP 

RIGHT 


① 


public class Foo { 
static int x; 


public void go() { 

System.out.println(x); 


② 


public class Foo2 { 
int x; 


④ 


public class Foo4 { 

static final int x = 12 ; 


public void go () { 

System.out.println(x); 


public static void go() { 
System.out.println(x) 

} 


public class Foo5 { 

static final int x = 12 ; 


public void go (final int x) 
System.out.println(x); 


public class Foo3 { 
final int x; 

public void go() { 

System.out.println(x); 


public class Foo6 { 

^ int x = 12; 

public static void go (final int x) { 
System.out.println(x); 
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Math methods 

Now that we know how static 
methods work, let’s look 
at some static methods in 
class Math. This isn’t all of 
them, just the highlights. 
Check your API for the rest 
including sqrt(), tan(), ceil(), 
floor()，and asin(). 


Math.random() 

Returns a double between 0.0 through (but 

not including) 1.0. 

double rl = Math.random(); 

int r2 = (int) (Math.random() * 5); 


Math.abs() 

Returns a double that is the absolute value of 
the argument. The method is overloaded, so 
if you pass it an int it returns an int. Pass it a 
double it returns a double. 

int x = Math.abs(-240); // returns 240 

double d = Math.abs(240.45); // returns 240.45 

Math.round() 

Returns an int or a long (depending on 
whether the argument is a float or a double) 
rounded to the nearest integer value. 

int x = Math.round(-24.8f); // returns -25 
int y = Math.round(24.45f); // returns 24 

Math.min() 

Returns a value that is the minimum of the 
two arguments. The method is overloaded to 
take ints, longs, floats, or doubles, 
int x = Math.min (24,240) ; // returns 24 

double y = Math.min(90876.5, 90876.49); // returns 90876.49 


Math.max() 

Returns a value that is the maximum of the 
two arguments. The method is overloaded to 
take ints y longs, floats, or doubles. 

int x = Math.max(24,240); // returns 240 

double y = Math.max(90876.5, 90876.49); // returns 90876.5 
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Wrapping a primitive 


Sometimes you want to treat a primitive like 
an object. For example, in all versions of Java 
prior to 5.0, you cannot put a primitive directly 
into a collection like ArrayList or HashMap: 


int x = 32; 

ArrayList list = new ArrayList(); 
list.add(x);^ 

lakes ml! (VayUs-t o^ly addO mctWs 
从 aUakc object rc^cv-c^cs, ^ 


There’s a wrapper class for every primitive type, 
and since the wrapper classes are in the java, 
lang package, you don’t need to import them. 
You can recognize wrapper classes because 
each one is named after the primitive type it 
wraps, but with the first letter capitalized to 
follow the class naming convention. 

Oh yeah, for reasons absolutely nobody on the 
planet is certain of, the API designers decided 
not to map the names exactly from primitive 
type to class type. You’ll see what we mean: 


Boolean 
Character ^ 

Byte ou*t! TKc 一 es aren't 

Short / mapped b> *tKc …勺七 

J / 七 vpcs . nc tlass ^ames arc A-ully 

Integer k ： s? 7 e|| c a out 

Long 


Float 

Double 

wrapping a value 

int i = 288; 
Integer iWrap : 


new 


Integer(i) 


fy\it primitive *to i\\c 
y/v-a^cv* £.oy\s*tv^*tov-. I 七 . 


f[\\ i\\t work 

like tWis. Boolean Kas a 

v V^as d AavVal ⑽ ()， d 
int unwrapped = iWrap.intValue(); 


unwrapping a value 



Wken you need to treat 
a primitive like an otject, 
wrap it. If you’re using any 
version ol Java tefore 5 •❶， 
you’ll do tkis wken you 
need to store a primitive 
value inside a collection like 


ArrayList or HaskMap. 



mt — ㈣ 


Note: the picture at the top is a chocolate in a foil wrapper. Get 
it? Wrapper? Some people think it looks like a baked potato, but 
that works too. 
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〆 / This is stupid. You mean I carVt 
just make an ArrayList of ints??? I 
have to wrap every single frickin* one in a new 
Integer object, then unwrap it when I try 
__ to access that value in the ArrayList? 
Thafs a waste of time and an error 

waiting to happen... k _^ 


before Java 5.0, YOU had to do the work 


She’s right. In all versions of Java prior to 5.0, primitives were primitives 
and object references were object references, and they were NEVER 
treated interchangeably. It was always up to you, the programmer, to do 
the wrapping and unwrapping. There was no way to pass a primitive to a 
method expecting an object reference, and no way to assign the result of a 
method returning an object reference directly to a primitive variable — even 
when the returned reference is to an Integer and the primitive variable is 
an int. There was simply no relationship between an Integer and an int, 
other than the fact that Integer has an instance variable of type int (to hold 
the primitive the Integer wraps). All the work was up to you. 


An ArrayList of primitive ints 

Without autoboxing (Java versio — 1 ^ — = … 



public void doNumsOldWay() { 


^lnr^xrTA o+■ 1 i o•hO a F>IiTm ， K^r % C! = n atat ^lnr^riTA c»+■ M • 
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Autoboxmg: blurring the \m 
between primitive ami object 


The autoboxing feature added to Java 5.0 does 
the conversion from primitive to wrapper object 
automatically! 

Let’s see what happens when we want to make an 
ArrayList to hold ints. 


An ArrayList of primitive ints 

With autoboxing (Java versions 5.0 or greater) 




Make 


public void doNumsNewWay() { 


ArrayList<Integer> listOfNumbers = new ArrayList<Integer>(); 



Why not declare an ArrayList<int> if you want to 
hold ints? 



厂 Y - Because...you can’t. Remember, the rule for generic 
types is that you can specify only class or interface types, nof 
primitives. So ArrayList<int> will not compile. But as you can 
see from the code above, it doesn't really matter, since the 
compiler lets you put ints into the ArrayList<lnteger>. In fact, 
there’s really no way to prevent you from putting primitives 
into an ArrayList where the type of the list is the type of that 
primitive’s wrapper, if you’re using a Java 5.0-compliant com¬ 
piler, since autoboxing will happen automatically. So,you can 
put boolean primitives in an ArrayList<Boolean> and chars 
into an ArrayList<Character>. 
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Autoboxing works almost everywhere 

Autoboxing lets you do more than just the obvious wrapping and 
unwrapping to use primitives in a collection... it also lets you use 
either a primitive or its wrapper type virtually anywhere one or the 
other is expected. Think about that! 

Fun with autoboxing 


Method arguments 

If a method takes a wrapper type, you 
can pass a reference to a wrapper or 
a primitive of the matching type. And 
of course the reverse is true—if a 
method takes a primitive, you can 
pass in either a compatible primitive 
or a reference to a wrapper of that 
primitive type. 


void 



takeNumber (Integer i) { } 


Return values 

If a method declares a primitive 
return type, you can return either a 
compatible primitive or a reference 
to the wrapper of that primitive type. 
And if a method declares a wrapper 
return type, you can return either a 
reference to the wrapper type or a 
primitive of the matching type. 


int giveNumber() { 



Boolean expressions 

Any place a boolean value is expected, 
you can use either an expression that 
evaluates to a boolean (4 > 2), or a 
primitive boolean, or a reference to a 
Boolean wrapper. 


n 

6 °°/e Q r\ boolean 

if (bool) { 

System, out .printIn (''true"); 
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Operations on numbers 

This is probably the strangest one—yes, you 
can now use a wrapper type as an operand 
in operations where the primitive type is 
expected. That means you can apply, say, 
the increment operator against a reference 
to an Integer object! 

But don’t worry—this is just a compiler trick. 
The language wasn't modified to make the 
operators work on objects; the compiler 
simply converts the object to its primitive 
type before the operation. It sure looks 
weird, though. 

Integer i = new Integer(42); 
i ++； 

And that means you can also do things like ： 

Integer j = new Integer(5); 

Integer k = j + 3; 


Assignments 

You can assign either a wrapper or primitive 
to a variable declared as a matching wrapper 
or primitive. For example, a primitive int 
variable can be assigned to an Integer 
reference variable, and vice-versa—a 
reference to an Integer object can be 
assigned to a variable declared as an int 
primitive. 





Will this code compile? Will it run? If it runs, 
what will it do? 

Take your time and think about this one; it 
brings up an implication of autoboxing that 
we didn’t talk about. 

You'll have to go to your compiler to find 
the answers. (Yes, we’re forcing you to 
experiment, for your own good of course.) 


public class TestBox { 

Integer i; 
int j; 

public static void main (String[] args) { 
TestBox t = new TestBox(); 
t.go(); 

} 

public void go() { 

j=i ； 

System.out.printin(j); 

System.out.printin(i); 
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Put wait! There's more! Wrappers 
have static utility methods too! 

Besides acting like a normal class, the wrappers have a 
bunch of really useful static methods. We’ve used one in 
this book before — Integer.parselnt(). 

The parse methods take a String and give you back a 
primitive value. 


Converting a String to a 卩 。 to 
primitive value is easy: ^ 2-. 

String s = '' 2 ，，; \ 

int x = Integer.parselnt(s); 

double d = Double .parseDouble (、、420 • 24 〃）； 


boolean b = new Boolean (''true") .booleanValue (); 


Vo^d twmk —d,，t 〆 4 卞 

Boolca^?a^cBoolca 如丄 ^ 


But if you try to do this: 

String t = 、 'two ”； 

int y = Integer.parselnt(t) 

You’ll get a runtime exception: 


厂 Wh-oh. This dorwpilcs jusi me, bui 
ai vujvtirwe i 七 blows up. 

; "tha 七匕如七 be p^vscd 3s 3 numbev* 

y/ill d Nurwbc\rFo\rrwa-tE>ctcp'tio^ 


File Edit Window Help Clue 


% java Wrappers 

Exception in thread 、 'main 〃 

java.lang.NumberFormatException : two 

at java.lang.Integer.parselnt(Integer.java:409) 

at java.lang.Integer.parselnt(Integer.java:458) 

at Wrappers.main(Wrappers.java : 9) 


Every method or 
constructor that parses 
a String can throw a 
NumberFormatException 
It’s a runtime exception, 
so you don’t have to 
handle or declare it. 

But you might want to. 

(We’ll talk about Exceptions in the 
next chapter.) 
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And how m reverse... turnihg a 
primitive number into a String 


There are several ways to turn a number into a String. 

The easiest is to simply concatenate the number to an 

—g String . 。心 ⑼ ) e t a 

• m Java ( 如 gw，added to a 


double d = 42.5; 
String doublestring 



double d = 42.5; 


String doublestring = Double.toString(d); 


Yeah, 

but how do I make it 
look like money? With a dollar 
sign and two decimal places 
like $56.87 or what if I want 
commas like 45,687,890 or 
what if I want it in... 




Where's my printf 
like I have in C? Is 
number formatting part of 
the I/O classes? 
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Number formatting 

In Java, formatting numbers and dates doesn’t have to be coupled with 1/O. Think 
about it. One of the most typical ways to display numbers to a user is through a 
GUI. You put Strings into a scrolling text area, or maybe a table. If formatting was 
built only into print statements, you’d never be able to format a number into a nice 
String to display in a GUI. Before Java 5.0, most formatting was handled through 
classes in the java.text package that we won’t even look at in this version of the 
book, now that things have changed. 

In Java 5.0, the Java team added more powerful and flexible formatting through a 
Formatter class in java.util. But you don’t need to create and call methods on the 
Formatter class yourself, because Java 5.0 added convenience methods to some of 
the I/O classes (including printf()) and the String class. So it’s a simple matter of 
calling a static String.format() method and passing it the thing you want formatted 
along with formatting instructions. 

Of course, you do have to know how to supply the formatting instructions, and 
that takes a little effort unless you’re familiar with the printf( ) function in C/C++. 
Fortunately, even if you don Y know printf() you can simply follow recipes for the 
most basic things (that we’re showing in this chapter). But you will want to learn 
how to format if you want to mix and match to get anything you want. 

We’ll start here with a basic example, then look at how it works. (Note: we’ll revisit 
formatting again in the I/O chapter.) 


Formatting a number to use commas 


public class TestFormats 


public static void main (String[] args) 





(y/c 



String s = String, format ('、 ％ , d", 1000000000); 

System. out. println (s) ; — 、/ — 

^ W the 

^ ^ ^ ^o d 


, 000 , 000,000 


"ow 


wc 


3 亡士 


i ^ 0 i he 
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Formatting deconstructed... 

At the most basic level, formatting consists of two main parts 
(there is more, but we’ll start with this to keep it cleaner) : 


Formatting instructions 

You use special format specifiers that describe how 
the argument should be formatted. 

The argument to be formatted. 

Although there can be more than one argument, we’ll 
start with just one. The argument type can’t be just 
anything... it has to be something that can be formatted 
using the format specifiers in the formatting instructions. 
For example, if your formatting instructions specify a 
floating point number, you can’t pass in a Dog or even a 
String that looks like a floating point number. 


从 () 


v-ead ta 代 Wb/! 


po * 
① 


:o 


"this. 


② 


format (、'%, d", 1000000000); 



r \ 

Use these instructions... on this argument. 


What do these instructions actually say? 

“Take the second argument to this method, and 
format it as a decimal integer and insert commas.” 


How do they say that? 

On the next page we’ll look in more detail at what the syntax “％， 
d” actually means, but for starters, any time you see the percent 
sign (%) in a format String (which is always the first argument 
to a format () method), think of it as representing a variable, 
and the variable is the other argument to the method. The rest 
of the characters after the percent sign describe the formatting 
instructions for the argument. 
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the format (: method 

The percent (%) says, "insert argument here" 

(and format it using these instructions) 

The first argument to a format () method is called the format String, and it 
can actually include characters that you just want printed as-is, without extra 
formatting. When you see the % sign, though, think of the percent sign as a 
variable that represents the other argument to the method. 


\L 


jfov-watO 




A^ur^chi i 0 be 


format(^1 have 


% .2f bugs 


to fix . ,r r 


476578.09876); 





The “％” sign tells the formatter to insert the other method argument (the 
second argument to format()，the number) here, AND format it using the 
“.2f’ characters after the percent sign. Then the rest of the format String, 

“bugs to fix”，is added to the final output. 

Adding a comma 

format (、'工 have % r . 2f bugs to fix.", 476578.09876); 



476,578.10 bugs to 



Watted 神 br 
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But how does it even KNOW 
where the instructions end and the 
rest of the characters begin? How come 
it doesiVt print out the 、、 f 〃 in 、、％ .2f 〃？ Or 
the u 2 〃？ How does it know that the .2f 
was part of the instructions and NOT 
part of the String? 


The format String uses its 
own little language syntax 

You obviously can’t put just anything after the “％” 
sign. The syntax for what goes after the percent 
sign follows very specific rules, and describes 
how to format the argument that gets inserted at 
that point in the result (formatted) String. 

You’ve already seen two examples: 

%， d means “insert commas and format the 
number as a decimal integer.” 

and 

%.2f means “format the number as a floating 
point with a precision of two decimal places.” 

and 

%”2f means “insert commas and format the 
number as a floating point with a precision of 
two decimal places.” 

The real question is really, “How do I know what 
to put after the percent sign to get it to do what 
I want?” And that includes knowing the symbols 
(like “d” for decimal and “f ’ for floating point) 
as well as the order in which the instructions 
must be placed following the percent sign. For 
example, if you put the comma after the “d” like 
this: “ ％ d,” instead of “ ％ ,d” it won’t work! 

Or will it? What do you think this will do: 

String, format (、'I have %.2f, bugs to fix. 〃， 476578.09876); 

(We’ll answer that on the next page.) 
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The format specifier 


Everything after the percent sign up to and including the type indicator (like 
“d” or “f’）are part of the formatting instructions. After the type indicator, the 
formatter assumes the next set of characters are meant to be part of the output 
String, until or unless it hits another percent (%) sign. Hmmmm... is that even 
possible? Can you have more than one formatted argument variable? Put that 
thought on hold for right now; we’ll come back to it in a few minutes. For now, 
let’s look at the syntax for the format specifiers — the things that go after the 
percent (%) sign and describe how the argument should be formatted. 

A format specifier can have up to five different parts (not 
including the Everything in brackets [ ] below is optional, so 

only the percent (%) and the type are required. But the order is 
also mandatory, so any parts you DO use must go in this order. 

% [argument number] [flags] [width] [ .precision] type 





i-tll be 

padded >/i 七 h zjcvocs. 


% [argument number] [flags] [width] [ .precision] type 



format , 6 • If ", 4 2.000); 
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The only required specifier is for TYPE 

Although type is the only required specifier, remember that if you do put 
in anything else, type must always come last! There are more than a dozen 
different type modifiers (not including dates and times; they have their own 
set), but most of the time you’ll probably use %d (decimal) or %f (floating 
point). And typically you’ll combine %f with a precision indicator to set the 
number of decimal places you want in your output. 


The TYPE is mandatory, everything else is optional. 


%d 


decimal 

format( 


、 '%d 〃 



i!^ 2 Ari d r kl l{ 


The argument must be compatible with an int, so that means 
only byte, short, int, and char (or their wrapper types). 


%f 


floating point 

format 42.000000); 


42.000 


Here 6 ⑽ Wed 於 f 

^?> } so ^ 


The argument must be of a floating point type, so that 
means only a float or double (primitive or wrapper) as well 
as something called BigDecimal (which we don’t look at in 
this book). 


You must include a 
type in your lormat 
instructions, anct il you 
specify tilings besides 
type, tke type must 
always come last . 

Most of tke time, 
you’ll proLaLly format 
numbers using eitker 

ff hi f I s I fff” 

d tor decimal or 士 
lor floating point. 


%x hexadecimal 

format ( 、'% X 〃 ， 42); 



The argument must be a byte, short, int, long (including 
both primitive and wrapper types), and Biglnteger. 


%c character 

format ( 、'% C ’’ ， 42); 





The argument must be a byte, short, char, or int (including 
both primitive and wrapper types). 
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What happens if I have more thaw om argument? 


Imagine you want a String that looks like this: 
“The rank is 20,456,654 out of 100,567,890.24：' 


But the numbers are coming from variables. What do you do? You simply add two 
arguments after the format String (first argument), so that means your call to format() 
will have three arguments instead of two. And inside that first argument (the format 
String), you’ll have two different format specifiers (two things that start with The 

first format specifier will insert the second argument to the method, and the second 
format specifier will insert the third argument to the method. In other words, the 
variable insertions in the format String use the order in which the other arguments are 
passed into the format() method. 


int one = 20456654; 

double two = 100567890.248907; 

String s = String, format (''The 




The rank is 20 f 456 f 654 out of 100,567,890.25 


l/Ve ddded -to bo-th vaHables ； 

ahd v*cs ■(: vifi.'tcci "the (loa 七 ’I% po’m 七 
… rwbev (-the sttoY\d vav-iablc) -to -two 
dctirwal places. 


you have 


， • 尸 w nave 4-k^ 


As you’ll see when we get to date formatting, you might actually want to apply different 
formatting specifiers to the same argument. That’s probably hard to imagine until you 
see how date formatting (as opposed to the number formating weVe been doing) works. 
Just know that in a minute, you’ll see how to be more specific about which format 
specifiers are applied to which arguments. 

Um, there’s something REALLY strange going on here. Just how many arguments can I 
pass? I mean, how many overloaded formatO methods are IN the String class? So, what happens 
if I want to pass, say, ten different arguments to be formatted for a single output String? 

A. 

Jr \ m Good catch. Yes, there is something strange (or at least new and different) going on, and 
no there are not a bunch of overloaded formatO methods to take a different number of possible 
arguments. In order to support this new formatting (printf-like) API in Java, the language needed 
another new feature — variable argument lists (called varargs for short). We'll talk about varargs 
only in the appendix because outside of formatting, you probably won't use them much in a well- 
designed system. 


300 chapter 10 






numbers and statics 


So much for numbers, what about dates? 

Imagine you want a String that looks like this: “Sunday，Nov 28 2004” 

Nothing special there, you say? Well, imagine that all you have to start with is a variable 
of type Date — A Java class that can represent a timestamp, and now you want to take that 
object (as opposed to a number) and send it through the formatter. 

The main difference between number and date formatting is that date formats use a 
two-character type that starts with “t” (as opposed to the single character “f’ or “d”，for 
example). The examples below should give you a good idea of how it works: 

The complete date and time %tc 

String • format ( 、 '%tc 〃 ， new Date ()); 


Sun Nov 28 14:52:41 MST 2004 


Just the time 


%tr 


String • format ( 、 '%tr" , new Date ()) 


03:01:47 



Day of the week, month and day 


%tA %tB %td 


There isn’t a single format specifier that will do exactly what we 
want, so we have to combine three of them for day of the week 
(%tA), month (%tB), and day of the month (%td). 

Date today = new Date(); 

String . format ( %tB %td" , today, today, today: 


wovl iL. o/,T / oih e . 


The to^a is no-t pairl o( the its d ,° ^ 


cm 

s-t 


Sunday , November 28 


Same as above, but without duplicating the arguments %tA %tB %td 


Date today = new Date(); 

String . format (%<tB %<td", today)/ 

of -this as kmd o-P like dall'ma 七 Wee 
饮⑶七 jrt-teir methods ok> ihc Vaic object, io 

thmcc d\U^CY\i pieces o( daia (rofn it 


The a^jlc-bvadkrt w < ;/ is jus-t ar>o-thcv- 
■flag \t\ -the spcdi-Picv- -that tells -the 
lovrwattcir -to w usc ihc Pvcvious 
ajam. w So i-t saves you vcpcatmg -the 
avjurwchts, av\d ms-tcad you -Povrwa-t -the 
sarwe thvee di-P-Pcv-cr>i ways. 
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manipulating dates 


■( Let's see... how many work ' 
days will there be if the 
project starts on Feb 27th and 
ends on August 5th? 


cP 


,4 


Working with Pates 

You need to do more with dates than just get 
today’s date. You need your programs to adjust 
dates, find elapsed times, prioritize schedules, 
heck, make schedules. You need industrial 
strength date manipulation capabilities. 

You could make your own date routines of 
course... (and don’t forget about leap years!) 



And, ouch, those occasional, pesky leap- 
seconds. Wow, this could get complicated. The 
good news is that the Java API is rich with 
classes that can help you manipulate dates. 
Sometimes it feels a little too rich... 
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Moving backward and forward m time 

Let’s say your company’s work schedule is Monday through Friday. 
You’ve been assigned the task of figuring out the last work day in 
each calendar month this year... 

It seems that java.util.Date is actually... out of date 

Earlier we used java.util.Date to find today’s date, so it seems 
logical that this class would be a good place to start looking for 
some handy date manipulation capabilities, but when you check 
out the API you’ll find that most of Date’s methods have been 
deprecated! 

The Date class is still great for getting a “time stamp” 一 an object 
that represents the current date and time, so use it when you want 
to say, “give me NOW”. 

The good news is that the API recommends java.util.Calendar 
instead, so let’s take a look: 


For a tiine-stamp of ”now' 
use Date. But for every tiling 
else, use Calenctar. 


Use java.util.Calendar for your date manipulation 

The designers of the Calendar API wanted to think globally, 
literally. The basic idea is that when you want to work with dates, 
you ask for a Calendar (through a static method of the Calendar 
class that you’ll see on the next page), and the JVM hands you back 
an instance of a concrete subclass of Calendar. (Calendar is actually 
an abstract class, so you’re always working with a concrete subclass.) 

More interesting, though, is that the kind of calendar you get 
back will be appropriate for your locale. Much of the world uses the 
Gregorian calendar, but if you’re in an area that doesn’t use a 
Gregorian calendar you can get Java libraries to handle other 
calendars such as Buddhist, or Islamic or Japanese. 

The standard Java API ships with java.util.GregorianCalendar, so 

that’s what we’ll be using here. For the most part, though, you 
don’t even have to think about the kind of Calendar subclass you’re 
using, and instead focus only on the methods of the Calendar class. 


you are here ► 


303 


getting a Calendar 

Getting aw object that extends Calendar 

How in the world do you get an “instance” of an abstract class? 

Well you don’t of course, this won’t work: 


This WONT work: 



Calendar cal = new Calendar(); 


The dompilc\r woh 七 allow -this / 


Instead, use the static “getlnstance()’’ method: 

Calendar cal = Calendar.getlnstance(); 


Tins syy>*t3% should look ^amiliav* "t-Ki- 
— mvokm^ d s*tcl*tid mc*t^od 



Wait a minute. 

If you cant make an 
instance of the Calendar 
class, what exactly are you 
assigning to that Calendar 
reference? 


You can’t get an instance of Calendar, 
but you can can get an instance of a 
concrete Calendar subclass. 

Obviously you can’t get an instance of Calendar, because 
Calendar is abstract. But you’re still free to call static methods 
on Calendar, since static methods are called on the class, 
rather than on a particular instance. So you call the static 
getlnstance() on Calendar and it gives you back... an instance 
of a concrete subclass. Something that extends Calendar 
(which means it can be polymorphically assigned to Calendar) 
and which — by contract — can respond to the methods of class 
Calendar. 

In most of the world, and by default for most versions of Java, 
you’ll be getting back a java.util.GregorianCalendar instance. 
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Working with Calendar objects 

There are several key concepts you’ll need to understand in 

order to work with Calendar objects: 

■ Fields hold state - A Calendar object has many fields that are used to 
represent aspects of its ultimate state, its date and time. For instance, you 
can get and set a Calendar’s year or month. 

■ Dates and Times can be incremented - The Calendar class has methods that 
allow you to add and subtract values from various fields, for example “add 
one to the month”，or “subtract three years”. 

■ Dates and Times can be represented in milliseconds ■ The Calendar class 
lets you convert your dates into and out of a millisecond representation. 
(Specifically, the number of milliseconds that have occured since January 
1st, 1970.) This allows you to perform precise calculations such as “elapsed 
time between two times” or “add 63 hours and 23 minutes and 12 seconds 
to this time”. 


An example of working with a Calendar object 

Calendar c = Calendar.getlnstance(); 

c.set(2004,0,7,15,40); 

long dayl = c. getTimelnMillis () ; - a^oun 



ect= 、 1 ,价 

jot 、 “咖 


dayl += 1000 * 60 * 60; 

c.setTimelnMillis(dayl); 

System. out • print In (''new 

c.add(c.DATE, 35); 

System. out • print In (''add 

c•roll(c•DATE, 35); 

System. out • print In (''roll 

c.set(c.DATE, 1); 

System. out .printIn (''set 


Add a 外 Kouv^s y/ov-tK millis, update time. 

Wohu X its like dayl 二 dayl + …). 


hour 


\\ 


c.get(c.HOUR OF DAY)); 


35 days + c. getTime ()); 


Add days io the dale, wh'uih 
should move us ihto Fcbv-uav-y. 


今 - 

35 days + c. getTime ()); 



to 1 '、+ c. getTime ()); 


u 尺 0 如 y s 0 lv t 0 "this date- This 
Volls w the da-tc ahead days, but 

Does not the moh-ch \ 



File Edit Window Help Time-Flies 


new hour 16 

add 35 days Wed Feb 11 16:40:41 MST 2004 
roll 35 days Tue Feb 17 16:40:41 MST 2004 
set to 1 Sun Feb 01 16:40:41 MST 2004 


This ou*tpu*t dov>-f iVms Kov/ millis, 
add, roll, a^d set wo\rk. 
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Highlights of the Calendar API 

We just worked through using a few of the fields and 
methods in the Calendar class. This is a big API, so 
we’re showing only a few of the most common fields 
and methods that you’ll use. Once you get a few of 
these it should be pretty easy to bend the rest of the 
this API to your will. 


Key Calendar Methods 


add(int field, int amount) 」 ， f M 

Adds or subtracts time from the calendars field. 

get(int field) 」 f M 

Returns the value of the given calendar field. 

getlnstanceO 

Returns a Calendar, you can specify a locale. 

getTimelnIVlillisO 

Returns this Calendars time in millis, as a long. 

rolKint field, boolean up) 

Adds or subtracts time without changing larger fiel 

set(int field, int value) 

Sets the value of a given Calendar field. 

set(year, month, day, hour, minute) (all ints) 

A common variety of set to seta complete time. 

setTimelnl\Aillis(long millis) 

Sets a Calendars time based on a long milli-time. 

// more... 


Key Calendar Fields 

DATE / DAY—OF—fl/IOIMTH 

Get/set the day of month 

HOUR / HOUR OF^DAY 

Get/set the 12hour or 24hourvalue 

MILLISECOND 

Get/set the milliseconds. 

a/iinute 

Get/set the minute. 

month 

Get / set the month. 

year 

Get/set the year. 

ZOME—OFFSET 

Get/set raw offset of GMT in millis. 

" more... 
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Evgw more Statics!... static imports 

New to Java 5.0." a real mixed blessing. Some people love 
this idea, some people hate it. Static imports exist only to save 
you some typing. If you hate to type, you might just like this 
feature. The downside to static imports is that - if you’re not 
careful - using them can make your code a lot harder to read. 

The basic idea is that whenever you’re using a static class, a 
static variable, or an enum (more on those later), you can 
import them, and save yourself some typing. 

Some old-fashioned code: 

import j ava.lang.Math; 

class NoStatic { 


Use Carefully ： 

static imports can 
make your cocte 
confusing to react 


public static void main(String [] args) { 

System, out. print In (''sqrt、' + Math . sqrt (2.0)); 
System, out. print In (''tan + Math • tan (60)); 


Same code, with static imports: 

import static java.lang.System.out; 



Caveats & Gotchas 


import static java.lang.Math.*; 

class WithStatic { 

public static void main(String [] args) { 

out • print In (''sqrt、' + sqrt (2.0)); 
out.println (''tan + tan (60)); 



■ If you’re only going to use a static member 
a few times, we think you should avoid 
static imports, to help keep the code more 
readable. 

■ If you’re going to use a static member a lot, 
(like doing lots of Math calculations), then 
it’s probably OK to use the static import. 

■ Notice that you can use wildcards (.*), in 
your static import declaration. 

■ A big issue with static imports is that it’s 
not too hard to create naming conflicts. For 
example, if you have two different classes 
with an “add()” method, how will you and 
the compiler know which one to use? 
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static vs. instance 


Fireside Chats 



Tonight’s Talk ： An instance variable 
takes cheap shots at a static variable 


Instance Variable 

I don’t even know why we’re doing this. 
Everyone knows static variables are just used 
for constants. And how many of those are 
there? I think the whole API must have, what, 
four? And it’s not like anybody ever uses 
them. 


Full of it. Yeah, you can say that again. OK, 
so there are a few in the Swing library, but 
everybody knows Swing is just a special case. 


Ok, but besides a few GUI things, give me an 
example of just one static variable that anyone 
would actually use. In the real world. 


Well, that’s another special case. And nobody 
uses that except for debugging anyway. 


Static Variable 


You really should check your facts. When 
was the last time you looked at the API? It’s 
frickin’ loaded with statics! It even has entire 
classes dedicated to holding constant values. 
There’s a class called SwingConstants, for 
example, that’s just full of them. 

It might be a special case, but it’s a really 
important one! And what about the Color 
class? What a pain if you had to remember the 
RGB values to make the standard colors? But 
the color class already has constants defined 
for blue, purple, white, red, etc. Very handy. 


How’s System.out for starters? The out in 
System.out is a static variable of the System 
class. You personally don’t make a new 
instance of the System, you just ask the System 
class for its out variable. 

Oh, like debugging isn’t important? 

And here’s something that probably never 
crossed your narrow mind — let’s face it, static 
variables are more efficient. One per class 
instead of one per instance. The memory 
savings might be huge! 
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Instance Variable 

Um, aren’t you forgetting something? 

Static variables are about as un-OO as it gets!! 
Gee why not just go take a giant backwards 
step and do some procedural programming 
while we’re at it. 

You’re like a global variable, and any 
programmer worth his PDA knows that’s 
usually a Bad Thing. 


Yeah you live in a class, but they don’t call 
it C/<255-Oriented programming. That’s just 
stupid. You’re a relic. Something to help the 
old-timers make the leap to java. 


Well, OK, every once in a while sure, it makes 
sense to use a static, but let me tell you, abuse 
of static variables (and methods) is the mark 
of an immature OO programmer. A designer 
should be thinking about object state, not class 
state. 

Static methods are the worst things of all, 
because it usually means the programmer is 
thinking procedurally instead of about objects 
doing things based on their unique object 
state. 


Static Variable 

What? 


What do you mean un-OO? 


I am NOT a global variable. There’s no such 
thing. I live in a class! That’s pretty OO you 
know, a CLASS. I’m not just sitting out there 
in space somewhere; I’m a natural part of the 
state of an object; the only difference is that 
I’m shared by all instances of a class. Very 
efficient. 


Alright just stop right there. THAT is 
definitely not true. Some static variables are 
absolutely crucial to a system. And even the 
ones that aren’t crucial sure are handy. 


Why do you say that? And what^ wrong with 
static methods? 


Sure, I know that objects should be the focus 
of an OO design, but just because there are 
some clueless programmers out there... don’t 
throw the baby out with the bytecode. There’s 
a time and place for statics, and when you 
need one, nothing else beats it. 


Riiiiiight. Whatever you need to tell yourself... 
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be the compiler 



class StaticSuper{ 
static { 


BE 如 compiler 



The Java file on lliis pa^e represents a 
complete program. Your job is to play 
compiler and determine whetiier tiiis 
file will compile. If it won’t compile, 
how would you fix it, and 
if it does compile, what 
would be its output? 


System, out .println( yy super static block ’’）； 


StaticSuper{ 

System.out.println( 

#super constructor ”）； 


public class StaticTests extends StaticSuper { 
static int rand; 

static { 

rand = (int) (Math.random() * 6); 

System.out .println( yy static block " + rand); 


If it compiles, which of these is 
the output? 


Possible Output 

File Edit Window Help Cling 


% java StaticTests 
static block 4 
in main 

super static block 
super constructor 
constructor 


StaticTests() { 

System.out.println("constructor"); 

} 

public static void main(String [] args) { 
System, out .println ( yy in main"); 
StaticTests st = new StaticTests(); 


Possible Output 

File Edit Window Help Electricity 


% java StaticTests 
super static block 
static block 3 
in main 

super constructor 
constructor 
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numbers and statics 


This chapter explored the wonderful, static, world 
of Java. Your job is to decide whether each of the 
following statements is true or false. 

ok Fawe ^ 

1. To use the Math class, the first step is to make an instance of it. 

2. You can mark a constructor with the static keyword. 

3. Static methods don’t have access to instance variable state of the ‘this’ object. 

4. It is good practice to call a static method using a reference variable. 

5. Static variables could be used to count the instances of a class. 

6. Constructors are called before static variables are initialized. 

7. MAX_SIZE would be a good name for a static final variable. 

8. A static initializer block runs before a class’s constructor runs. 

9. If a class is marked final, all of its methods must be marked final. 

10. A final method can only be overridden if its class is extended. 

11. There is no wrapper class for boolean primitives. 

12. A wrapper is used when you want to treat a primitive like an object. 

13. The parseXxx methods always return a String. 

14. Formatting classes (which are decoupled from I/O)，are in the java.format 
package. 
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code magnets 


秦 



Lunar Code Magnets 


This one might actually be useful! In addition to what you’ve learned in the last few 
pages about manipulating dates,you'll need a little more information... First,full 
moons happen every 29.52 days or so. Second, there was a full moon on Jan. 7th, 
2004. Your job is to reconstruct the code snippets to make a working Java program 
that produces the output listed below (plus more full moon dates). (You might not 
need all of the magnets, and add all the curly braces you need.) Oh, by the way, your 
output will be different if you don’t live in the mountain time zone. 


File Edit Window Help Howl 


% java FullMoons 

full moon on Fri Feb 06 04:09:35 MST 2004 
full moon on Sat Mar 06 16:38:23 MST 2004 
full moon on Mon Apr 05 06:07:11 MDT 2004 



static import java.lang.System.out; 


• -- _ 

c.set(2004,0,7,15,40); 


out.println 


c.setTim e 工 
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Exercise Solutions 


True or False 


numbers and statics 


BE 如 compiler 


StaticSuper( ) { 

System.out.println( 
"super constructor"); 


StaticSuper is a constructor, and must 
have () in its signature. Notice that as 
the output below demonstrates, the static 
blocks for both classes run before either 
of the constructors run. 


Possible Output 

File Edit Window Help Cling 


% java StaticTests 
super static block 
static block 3 
in main 

super constructor 
constructor 


1. To use the Math class, the first step is to False 

make an instance of it. 

2. You can mark a constructor with the key- Folse 
word ‘static’. 

3. Static methods don’t have access to an True 

object’s instance variables. 

4. It is good practice to call a static method False 
using a reference variable. 

5. Static variables could be used to count the True 
instances of a class. 

6. Constructors are called before static vari- False 
ables are initialized. 

7. MAX_SIZE would be a good name for a True 
static final variable. 


8. A static initializer block runs before a class’s True 
constructor runs. 

9. If a class is marked final, all of its methods False 
must be marked final. 

10. A final method can only be overridden if False 
its class is extended. 

11. There is no wrapper class for boolean False 

primitives. 

12. A wrapper is used when you want to treat a True 
primitive like an object. 

13. The parseXxx methods always return a False 
String. 

14. Formatting classes (which are decoupled False 
from 1/O), are in the java.format package. 
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Exercise Solutions 


import java.util.*; 

import static java.lang.System.out; 
class FullMoons { 

static int DAY—IM = 1000 * 60 * 60 * 24; 
public static void main(String [] args) { 
Calendar c = Calendar.getlnstance(); 
c.set(2004,0,7,15,40); 
long dayl = c.getTimelnMillis (); 
for (int x = 0; x < 60; x++) { 

dayl += (DAY 一 IM * 29.52) 
c.setTimelnMillis(dayl); 


Notes on the Lunar Code Magnet: 

You might discover that a few of the 
dates produced by this program are 
off by a day. This astronomical stuff 
is a little tricky, and if we made it 
perfect, it would be too complex to 
make an exercise here. 

Hint: one problem you might try to 
solve is based on differences in time 
zones. Can you spot the issue? 


out .println (String, format (''full moon on %tc^ , c)); 


File Edit Window Help Howl 


% java FullMoons 

full moon on Fri Feb 06 04:09:35 MST 2004 
full moon on Sat Mar 06 16:38:23 MST 2004 
full moon on Mon Apr 05 06:07:11 MDT 2004 
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Risky Behavior 



Stuff happens. The file isn’t there. The server is down. No matter how 

good a programmer you are, you can’t control everything.Things can go wrong. Very wrong. 
When you write a risky method, you need code to handle the bad things that might happen. 

But how do you /enow when a method is risky? And where do you put the code to handle the 
exceptional situation? So far in this book, we haven’t really taken any risks. We’ve certainly had 
things go wrong at runtime, but the problems were mostly flaws in our own code. Bugs. And 
those we should fix at development time. No, the problem-handling code we’re talking about 
here is for code that you can’t guaranatee will work at runtime. Code that expects the file to be 
in the right directory, the server to be running, or the Thread to stay asleep. And we have to do 
this now. Because in this chapter, we’re going to build something that uses the risky JavaSound 
API. We’re going to build a MIDI Music Player. 
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building the MIDI Music Player 

Lcfs make a Music Machine 

Over the next three chapters, we’ll build a few different sound 
applications, including a BeatBox Drum Machine. In fact, 
before the book is done, we’ll have a multi-player version so 
you can send your drum loops to another player, kind of like 
a chat room. You’re going to write the whole thing, although 
you can choose to use Ready-bake code for the GUI parts. 

OK, so not every IT department is looking for a new BeatBox 
server, but we’re doing this to learn more about Java. Building 
a BeatBox is just a way to have fun while we’re learning Java. 

The finished PeatPox looks something like this: 
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Put checkmarks in the boxes for each of the 16 ‘beats’. For example, on beat 

1 (of 16) the Bass drum and the Maracas will play, on beat 2 nothing, and 
on beat 3 the Maracas and Closed Hi-Hat … you get the idea. When you hit 
‘Start’，it plays your pattern in a loop until you hit ‘Stop’. At any time, you 
can “capture” one of your own patterns by sending it to the BeatBox server 
(which means any other players can listen to it). You can also load any of the 
incoming patterns by clicking on the message that goes with it. 


p/^y it 
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exception handling 


Well start with the basics 

Obviously we’ve got a few things to learn before the whole 
program is finished, including how to build a Swing GUI, how 
to connect to another machine via networking, and a little I/O 
so we can send something to the other machine. 

Oh yeah, and the JavaSound API. That s where we’ll start in this 
chapter. For now, you can forget the GUI, forget the networking 
and the I/O, and focus only on getting some MIDI-generated 
sound to come out of your computer. And don’t worry if you 
don’t know a thing about MIDI, or a thing about reading or 
making music. Everything you need to learn is covered here. 
You can almost smell the record deal. 


The JavaSouwd API 

JavaSound is a collection of classes and interfaces added to 
Java starting with version 1.3. These aren’t special add-ons; 
they’re part of the standard J2SE class library. JavaSound is split 
into two parts: MIDI and Sampled. We use only MIDI in this 
book. MIDI stands for Musical Instrument Digital Interface, 
and is a standard protocol for getting different kinds of 
electronic sound equipment to communicate. But for 
our BeatBox app, you can think of MIDI as a kind of 
sheet music that you feed into some device you can think 
of like a high-tech ‘player piano’. In other words, MIDI 
data doesn’t actually include any sound, but it does 
include the instructions that a MIDI-reading instrument 
can play back. Or for another analogy, you can think of 
a MIDI file like an HTML document, and the instrument 
that renders the MIDI file (i.e. plays it) is like the Web 
browser. 
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MIDI data says what to do (play middle C, and here’s how hard 
to hit it, and here’s how long to hold it, etc.) but it doesn’t say 
anything at all about the actual sound you hear. MIDI doesn’t 
know how to make a flute, piano, or Jimmy Hendrix guitar 
sound. For the actual sound, we need an instrument (a MIDI 
device) that can read and play a MIDI file. But the device is 
usually more like an entire band or orchestra of instruments. And 
that instrument might be a physical device, like the electronic 
keyboard synthesizers the rock musicians play, or it could 
even be an instrument built entirely in software, living in your 
computer. 

For our BeatBox, we use only the built-in, software-only 
instrument that you get with Java. It’s called a synthesizer (some 
folks refer to it as a software synth) because it creates sound. 
Sound that you hear. 
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but it looked so simple 


First m need a Sequencer 

Before we can get any sound to play, we need a Sequencer object. The 
sequencer is the object that takes all the MIDI data and sends it to the right 
instruments. It’s the thing that plays the music. A sequencer can do a lot of 
different things, but in this book, we’re using it strictly as a playback device. Like 
a CD-player on your stereo, but with a few added features. The Sequencer class 
is in the javax.sound.midi package (part of the standard Java library as of version 
1.3). So let’s start by making sure we can make (or get) a Sequencer object. 


import javax.sound.midi.* 


public class MusicTestl 


public void play() { 

Sequencer sequencer = MidiSystem.getSequencer() 


System, out .printIn (''We got a sequencer " 〉 
} // close play 


恤 MIP1 ，卞 : r 七 

a —' ^亡二 ㈣ 

^ ov\t ouvscwcs 

to rc OV.C. 






public static void main(String[] args) { 

MusicTestl mt = new MusicTestl(); 
mt.playO ; 

} // close main 

} // close class Something's wrong! 

J WiS todc WOh ^ The says i^s ah 

u 价吓饮 ted that b c deda^d. 


File Edit Window Help SayWhat? 



T 



% javac MusicTestl.java 

MusicTestl.j ava:13: unreported 

exception 

javax.sound.midi. 

MidiUnavailableException; 

must 

be caught 

or declared to be 

thrown 

Sequencer sequencer = 

MidiSystem.getSequencer(); 

A 

1 errors 
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exception handling 


What happens when a method you want to call 
(probably m a class you didn't write) is risky? 


① Let’s say you want 
to call a method in a 


class that you didn’t 
write. 



you 


didiVt write 


② That method does 
something risky ， 
something that might 
not work at runtime. 



didiVt write 


void moo () { 

if (serverDown) { 
explode(); 

} 

} 


③ You need to know 
that the method 
you’re calling is 
risky. 


④ You then write code 
that can handle the 
failure if it does 
happen. You need to be 
prepared, just in case. 



you dldn，+ wrl+e 


Now that I 
know, I can take 
、 precautions. 



you 
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when things might go wrong 


Methods in Java use exceptions to tell the calling code, 

"Something Pad Happened. I failed^ 


Java’s exception-handling mechanism is a clean, well-lighted way to handle “exceptional 
situations” that pop up at runtime; it lets you put all your error-handling code in one 
easy-to-read place. It’s based on you knowing that the method you’re calling is risky 
(i.e. that the method might generate an exception), so that you can write code to deal 
with that possibility. If you know you might get an exception when you call a particular 
method, you can be prepared for — possibly even recover from — the problem that caused 
the exception. 

So, how do you know if a method throws an exception? You find a throws clause in the 
risky method’s declaration. 


The getSequencer () method takes a risk. It can fail at runtime. 
So it must ^declare 9 the risk you take when you call it. 
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The compiler needs to know 
that YOV know youVc calling 
a risky method. 

If you wrap the risky code in something called a 
try/catch, the compiler will relax. 

A try/catch block tells the compiler that you 
know an exceptional thing could happen in the 
method you’re calling, and that you’re prepared 
to handle it. That compiler doesn’t care how you 
handle it; it cares only that you say you’re taking 
care of it. 

import javax.sound.midi.*; 

public class MusicTestl { 
public void play() { 
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a// ’讀6喊 “如. 


try { 

Sequencer sequencer = MidiSystem.getSequencer(); 
System, out .println (''Successfully got a sequencer"); 
} catch(MidiUnavailableException ex) { 

System, out.println (''Bummer"); 

} 

} // close play 


out v-w 7 - ••” 


public static void main(String[] args) { 
MusicTestl mt = new MusicTestl(); 
mt.playO ; 

} // close main 
} // close class 
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exceptions are objects 


rm gonna 

TRY this risky thing 
and rm gonna 
CATCH myself if I fall. 



Don’t try this at home. 


Throwable 

getMessage() 

printStackTrace() 


part d 七 ^ u 

tlass T^aWe 

孙 d '^cr\i kc'f 



lOException 





u 


An exception is an object 
of type Exception. 


Which is fortunate, because it would be much harder 
to remember if exceptions were of type Broccoli. 

Remember from your polymorphism chapters that 
an object of type Exception can be an instance of any 
subclass of Exception. 

Because an Exception is an object, what you catch is an 
object. In the following code, the catch argument 
is declared as type Exception, and the parameter 
reference variable is ex. 




try { 

//do risky thing *t ，s t 

^' a f ’ 

} catch(Exception ex) { 

// try to recover 

} ° hly ^ a 

is l, ,十 ^ 

What you write in a catch block depends on the 
exception that was thrown. For example, if a server 
is down you might use the catch block to try another 
server. If the file isn’t there, you might ask the user 
for help finding it. 
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If ifs your code, that catches the exception, 
thew whose code throws it? 

■ I JfTH I 1 

You’ll spend much more of your Java coding time handling 
exceptions than you’ll spend creating and throwing them yourself. 

For now, just know that when your code calls a risky method — a 
method that declares an exception — it’s the risky method that 
throws the exception back to you, the caller. 

In reality, it might be you who wrote both classes. It really 
doesn’t matter who writes the code... what matters is knowing 
which method throws the exception and which method catches it. 

When somebody writes code that could throw an exception, they 
must declare the exception. 

.MUST ^ ^ 

① Risky, exception-throwing code: ^ ^a-t ^ f '' rOVlS 



public void takeRisk() 


throws 


BadException 


if (abandonAllHope) { 

new BadException(); 


throw 






② Your code that calls the risky method: 


public void crossFingers() { 


try 


anObject.takeRisk(); 
catch (BadException ex) { 


System, out.println (''Aaargh! 
ex.printStackTrace(); 


One method Will 
cqtA another 

method 哇 K>\Vs . An 

exception Is al\V£l/s 

thrown kaokto ihe 
caller- 

Ttie method tfcqt 

tliTQWs li£is tP declare 
th^tt it thtQW 
tte exception- 
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checked and unchecked exceptions 


The compiler checks for everything 
except RuntimeExceptions. 


Ewptiohs that av-c hlOT subclasses o-P 
RuhtirhcExdcptioh a\rc dhedked by 
the dompil 饮 . ThcyVc called ^hedked 


The compiler guarantees: 

If you throw an exception in your code you must declare it using 
the throws keyword in your method declaration. 



VJl Wait just a minute! How come this is the FIRST time 
w^ve had to try/catch an Exception? What about the 
exceptions I've already gotten like NullPointerException 
and the exception for DivideByZero. I even got a 
NumberFormatException from the Integer.parselntO 
method. How come we didn't have to catch those? 


The compiler cares about all subclasses of Exception, 
unless they are a special type, RuntimeException. Any 
exception class that extends RuntimeException gets a 
free pass. RuntimeExceptions can be thrown anywhere, 
with or without throws declarations or try/catch blocks. 
The compiler doesn’t bother checking whether a method 
declares that it throws a RuntimeException, or whether the 
caller acknowledges that they might get that exception at 
runtime. 


1 HI bite. WHY doesn’t the compiler care about those 
runtime exceptions? Aren’t they just as likely to bring the 
whole show to a stop? 

Most RuntimeExceptions come from a problem in 
your code logic, rather than a condition that fails at runtime 
in ways that you cannot predict or prevent. You cannot 
guarantee the file is there. You cannof guarantee the server 
is up. But you can make sure your code doesn’t index off the 
end of an array (that’s what the .length attribute is for). 

You WANT RuntimeExceptions to happen at development 
and testing time. You don't want to code in a try/catch, for 
example, and have the overhead that goes with it, to catch 
something that shouldn’t happen in the first place. 

A try/catch is for handling exceptional situations, not flaws 
in your code. Use your catch blocks to try to recover from 
situations you can’t guarantee will succeed. Or at the very 
least, print out a message to the user and a stack trace, so 
somebody can figure out what happened. 


324 





















exception handling 



■ 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


BULLET POINT 


A method can throw an exception when something fails at runtime. 

An exception is always an object of type Exception. (Which, as you 
remember from the polymorphism chapters means the object is from a 
class that has Exception somewhere up its inheritance tree.) 

The compiler does NOT pay attention to exceptions that are of 
type RuntimeException. A RuntimeException does not have to be 
declared or wrapped in a try/catch (although you’re free to do either or 
both of those things) 

All Exceptions the compiler cares about are called ‘checked 
exceptions’ which really means compiler-checked exceptions. Only 
RuntimeExceptions are excluded from compiler checking. All other 
exceptions must be acknowledged in your code, according to the 
rules. 

A method throws an exception with the keyword throw, followed by 
a new exception object: 

throw new NoCaffeineException(); 

Methods that might throw a checked exception mwsf announce it with 
a throws Exception declaration. 

If your code calls a checked-exception-throwing method, it must 
reassure the compiler that precautions have been taken. 

If you’re prepared to handle the exception, wrap the call in a try/catch, 
and put your exception handling/recovery code in the catch block. 

If you’re not prepared to handle the exception, you can still make the 
compiler happy by officially ‘ducking’ the exception. We’ll talk about 
ducking a little later in this chapter. 


Iharpen your pencil 


t#lp 

Hy0 u're trying to »ea^ 

before s 工 can tear yourS elf 

book down any thing else more 

away from don k of a cheerios™ 
challenging than ^ process what 

box. Your brain That could take 

y0U We read and learned.™^ 

a n I e ： S.:k 声她娜 eofthe 
java might not 'stick. 

Of course 

a physical foxing routine 


f 


摯. 


t ii oom KickBoxing routine 
java learninQ. 

For the best results, read this 

book (or at least look a 
Ik, the pictures) right before 
going to sleep. 


Things you want to do 


What might go wrong 


Which of these do you think 
might throw an exception that 
the compiler would care about? 
We’re only looking for the 
things that you can’t control in 
your code. We did the first one. 

(Because it was the easiest.) 


V^connect to a remote server 七 he sgrvgrjs dovm 

— access an array beyond its length _ 

— display a window on the screen _ 

— retrieve data from a database _ 

— see if a text file is where you think it is_ 

— create a new file _ 

read a character from the command-line 
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exceptions and low control 

Flow control iw try/catch blocks 

When you call a risky method, one of two things can hap¬ 
pen. The risky method either succeeds, and the try block 
completes, or the risky method throws an exception back to 
your calling method. 


If the try Succeeds 

(doRiskyThing() does not 
throw an exception) 


6ode bdow 


y-wS, 


try { 


① 

1 - 

Foo f = x.doRiskyThing(); 

int b = f.getNum(); 

丁 k 6ode …如 

6 必 Wotk …伏 

} catch (Exception ex) { 

/ 

% java Tester 


System. out .printIn (''failed 


We made it! 




If the try fails 

(because doRiskyThing() 
does throw an exception) 


t0 I- \o 

r 口二. 


we 從二 


try { 

-(l)-Foo f = x. doRiskyThing () ; se iv n 

int b = f . getNum () ; 4^" 匕二 〆 ;': '岣 






catch (Exception ex) { 

System. out .printIn ( 、 'failed 〃）； 


System. out. print In (''We made it !’’）； 


File Edit Window Help RiskAII | 


% java Tester 

failed 

We made it! 
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Finally: for the things you want 
to do m matter what 


exception handling 


If you try to cook something, you start by turning on 
the oven. 

If the thing you try is a complete failure, 
you have to turn off the oven. 

If the thing you try succeeds, 
you have to turn off the oven. 

You have to turn off the oven no matter what! 

A finally block is where you put 
code that must run regardless 
of an exception. 


try { 

turnOvenOn(); 
x.bake(); 

} catch (BakingException ex) 
ex.printStackTrace (); 

} finally { 

turnOvenOff (); 



No matter what, do NOT let 
me forget to turn off the 
oven! Last time I torched half 
the neighborhood. 


Without finally，you have to put the 
turnOvenOff () in both the try and the catch 
because you have to turn off the oven no matter 
what A finally block lets you put all your 
important cleanup code in one place instead of 
duplicating it like this: 


If the try block fails (an exception), flow 
control immediately moves to the catch block. 
When the catch block completes, the finally 
block runs. When the finally block completes, 
the rest of the method continues on. 


try { 

turnOvenOn(); 


x.bake(); 
turnOvenOff (); 

} catch (BakingException ex) 
ex.printStackTrace (); 
turnOvenOff(); 


If the try block succeeds (no exception), 

flow control skips over the catch block and 
moves to the finally block. When the finally 
block completes, the rest of the method 
continues on. 

If the try or catch block has a return 
statement, finally will still run! Flow 
jumps to the finally, then back to the return. 
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flow control exercise 



Flow Control 


Look at the code to the left. What do you think the 
output of this program would be? What do you think 
it would be if the third line of the program were 
changed to: String test = "yes"; ? 

Assume ScaryException extends Exception. 


public class TestExceptions { 

public static void main(String [] args) { 

String test = "no" ; 
try { 

System, out .println( /y start try^ ); 
doRisky(test); 

System, out .print In ( yy end try"); 

} catch ( ScaryException se) { 

System.out .printIn(scary exception"); 

} finally { 

System.out .printIn( "finally"); 

} 

System, out .print In (end of main"); 

} 

static void doRisky(String test) throws ScaryException { 
System, out .printIn(start risky''); 
if ("yes 〃 .equals(test)) { 

throw new ScaryException(); 

} 

System, out .printIn(end risky''); 
return; 


Output when test = "no 〃 


Output when test = "yes 


ujBiujo pua - A||euy - uojidaDxa Ajbds - A>|su jjeis - Aji ijbis = isai uaqyvv 
ujeiu p pua - X||Buy - Aji pua - A>|su pua - A>|su - Aji : "ou,,= isai U3i|/v\ 


328 chapter 11 






exception handling 


Vid we mention that a method caw 
throw more thaw om exception? 

A method can throw multiple exceptions if it darn well needs to. But 
a method’s declaration must declare all the checked exceptions it can 
throw (although if two or more exceptions have a common superclass, the 
method can declare just the superclass.) 


Catching multiple exceptions 

The compiler will make sure that you’ve handled all the checked excep¬ 
tions thrown by the method you’re calling. Stack the catch blocks under 
the try, one after the other. Sometimes the order in which you stack the 
catch blocks matters, but we’ll get to that a little later. 




public class Laundry { 

public void doLaundry () throws PantsException , Linge-leException 

// code that could throw either exception 


TWO 


、办 od 


bfjo, ^ 




new Laundry() 


public class Foo { 

public void go() { 

Laundry laundry = 

try { 

laundry.doLaundry() 

} catch(PantsException 

// recovery code 



doLauhdlryO "thirows s 

it Idhds ihe 
Pah*ts£>cdcp"tioh datdh blodk. 


catch(LingerleExcepti 

// recovery code 


ic^lex) { 
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polymorphic exceptions 


Exceptions are polymorphic 


Exceptions are objects, remember. There’s nothing all that 
special about one, except that it is a thing that can be thrown. 

So like all good objects, Exceptions can be referred to 
polymorphically. A LingerieException object, for example, 
could be assigned to a ClothingException reference. A 
PantsException could be assigned to an Exception reference. 
You get the idea. The benefit for exceptions is that a method 
doesn’t have to explicitly declare every possible exception it 
might throw; it can declare a superclass of the exceptions. 
Same thing with catch blocks — you don’t have to write a catch 
for each possible exception as long as the catch (or catches) 
you have can handle any exception thrown. 


① You can DECLARE exceptions using 
a supertype of the exceptions you 
throw. 



public void doLaundry () throws ClothingException { 




故 525 ^: 


叫 “ wi-tu-t CXP L// 


： iOh, 


Exception 


as a 

su\>cv6\3 ss - 


lOException 



ClothingException 




LingerieException 

ShirtException 

T\ 



/ 



TeeShirtException 

DressShirtException 


m 

‘■& > 


② You can CATCH exceptions using a 
supertype of the exception thrown. 

try { 

laundry.doLaundry(); 

I 

} catch(ClothingException cex) { 


^ svaV)^^ sS 


try { 




pyCSS^ 


laundry.doLaundry(); 

r 9k 




si 



} catch(ShirtException sex) { 


// recovery code 


// recovery code 
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exception handling 


Just because you CAN catch everything 
with one big super polymorphic catch, 
doesn’t always mean you SHOULD. 


You could write your exception-handling code so that 
you specify only one catch block, using the supertype 
Exception in the catch clause, so that you’ll be able to 
catch any exception that might be thrown. 


try { 


laundry.doLaundry(); 


} catch (Exception ex) { , u .w ^\\\ 

// recovery code . . . ^ — V so '/ova 

> • A 亡二： :二叫 . 


Write a different catch block for each 
exception that you need to handle 
uniquely. 

For example, if your code deals with (or recovers 
from) a TeeShirtException differently than it handles a 
LingerieException, write a catch block for each. But if you 
treat all other types of ClothingException in the same way, 
then add a ClothingException catch to handle the rest. 


try { 


laundry.doLaundry() 



} catch(TeeShirtException tex) { 

// recovery from TeeShirtException 



} catch(Linger^eException lex) { 

// recovery from LingerieException 










} catch(ClothingException cex) { 

// recovery from all others 
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order of multiple catch blocks 


Multiple catch blocks must be ordered 
from smallest to biggest 



yet 


經 s’ 


catch(TeeShirtException tex) 


覊 










sJocA〆 


art 



catch(ShirtException sex: 



PantsException 

LingerieException 

ShirtException 

UniformExc ㈣ :/ >n 




鼻 



TeeShirtException 

SP 

：7 


DressShirtException 


m 







catch(ClothingException cex) 


The higher up the inheritance tree, the bigger the 
catch ‘basket’. As you move down the inheritance 
tree, toward more and more specialized Exception 
classes, the catch ‘basket’ is smaller. It’s just plain old 
polymorphism. 

A ShirtException catch is big enough to take 
a TeeShirtException or a DressShirtException 
(and any future subclass of anything that extends 
ShirtException). A ClothingException is even bigger 
(i.e. there are more things that can be referenced 
using a ClothingException type). It can take an 
exception of type ClothingException (duh), and 
any ClothingException subclasses: PantsException, 
UniformException, LingerieException, and 
ShirtException. The mother of all catch arguments 
is type Exception; it will catch any exception, 
including runtime (unchecked) exceptions, so you 
probably won’t use it outside of testing. 
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You caw't put bigger baskets 
above smaller baskets. 


exception handling 


Well, you can but it won’t compile. Catch 
blocks are not like overloaded methods 


where the best match is picked. With catch 
blocks, the JVM simply starts at the first one 
and works its way down until it finds a catch 
that’s broad enough (in other words, high 
enough on the inheritance tree) to handle 
the exception. If your first catch block is 
catch (Exception ex) ， the compiler 
knows there’s no point in adding any 
others — they’ll never be reached. 



} catch(Clothing { 

// recovery from ClothingException 


} catch(LingerieException lex) { 

// recovery from LingerieException 


/ Size matters when 
you have multiple catch 
blocks. The one with the biggest 
basket has to be on the bottom. 
Otherwise, the ones with 
smaller baskets are useless. 1 




catch(ShirtException sex; { 

// recovery from ShirtException 


Sittings can in any order, because tkey 
can’t catck one anotker s exceptions. 

You could put ShirtException above 
LingerieException and nobody would mind. 
Because even though ShirtException is a bigger 
(broader) type because it can catch other classes 
(its own subclasses), ShirtException can’t catch a 
LingerieException so there’s no problem. 
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polymorphic puzzle 


Assume the try/catch block here is legally coded. Your task is to draw 
two different class diagrams that can accurately reflect the Exception 
classes. In other words, what class inheritance structures would make the 
try/catch blocks in the sample code legal? 

try { 

x.doRisky(); 

} catch(AlphaEx a) { 

// recovery from AlphaEx 

} catch(BetaEx b) { 

// recovery from BetaEx 

} catch(GammaEx c) { 

// recovery from GammaEx 

} catch(DeltaEx d) { 

// recovery from DeltaEx 



harpen your pencil 



Your task is to create two different legal try / catch structures (similar to 
the one above left), to accurately represent the class diagram shown on 
the left. Assume ALL of these exceptions might be thrown by the method 
with the try block. 
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exception handling 


Whew you don't wawt to handle 


aw exception... 



If you don’t want to handle an 
exception, you can duck it by 


What the...? 

There is NO way I’m 
catching that thing, rm gettiiV 
out of the way— somebody 
behind me can handle it. 


declaring it. 

When you call a risky method, the compiler 
needs you to acknowledge it. Most of the time, 
that means wrapping the risky call in a try/ 
catch. But you have another alternative, simply 
duck it and let the method that called you catch 
the exception. 

It’s easy — all you have to do is declare that 
you throw the exceptions. Even though, 
technically, you aren’t the one doing the 
throwing, it doesn’t matter. You’re still the one 
letting the exception whiz right on by. 

But if you duck an exception, then you don’t 
have a try/catch, so what happens when the 
risky method (doLaundryO) does throw the 
exception? 



When a method throws an exception, that 


method is popped off the stack immediately, 
and the exception is thrown to the next 


method down the stack — the caller. But if the 


caller h a ducker, then there’s no catch for it so 
the caller pops off the stack immediately, and 
the exception is thrown to the next method 
and so on... where does it end? You’ll see a 
little later. 



public void foo () throws ReallyBadException { 


// call risky method without a try/catch 


laundry.doLaundry(); 


JOVA 、 
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handle or declare 


doLaundry() pops off the 
stack immediately and 
the exception is thrown 
back to foo(). 

But f 00() doesn’t have a 
try/catch, so... 


o 


doLaundry() throws a 
ClothingException 



main() calls foo() 

foo() calls doLaundryO 

doLaundryO is 
running and throws a 
ClothingException 



We’re using the tee-shirt to represent a Clothing 
Exception. We know, we know... you would 
have preferred the blue jeans. 


© main() ducks the The JVM 

exception shuts down 



foo() pops off the 
stack immediately and 
the exception is thrown 
back to... who? What? 
There’s nobody left 
but the JVM y and \fs 
thinking,、、DoiVt expect 
ME to get you out of 
this." 


Puckmg (by declaring) only 
delays the inevitable 

Sooner or later, somebody has to 
deal with it. But what if main() 
ducks the exception? 

public class Washer { 

Laundry laundry = new Laundry(); 

public void foo () throws ClothingException 

laundry.doLaundry(); 

} 

public static void main (String [ ] args) throws ClothingException { 
Washer a = new Washer(); 
a.foo (); 
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Handle or Declare. Ifs the law. 


exception handling 


So now we’ve seen both ways to satisfy the compiler 
when you call a risky (exception-throwing) method. 


① HANDLE 

Wrap the risky call in a try/catch 
try { 

laundry.doLaundry(); 

} catch(ClothingException cex) 

// recovery code 

} 




② DECLARE (duck it) 

Declare that YOUR method throws the same exceptions , v a 

as the risky method youre calling. 丁 ^ doUavAVX d^0 ^ de6 \ a — 加 

void f oo ( ) throws ClothingException { C oO 0 

laundry. doLaundry () ; N (。 

} Mk 咖 —- 

But now this means that whoever calls the foo() method 
has to follow the Handle or Declare law. If foo() ducks 
the exception (by declaring it), and main。calls foo(), then 
main() has to deal with the exception. 

public class Washer { 

Laundry laundry = new Laundry(); 


public void foo () throws ClothingException 
laundry.doLaundry(); 

} 


public static void main (String[] args) 
Washer a = new Washer(); 
a.foo (); 

1 

o ? -thmowh by doUuhdryO, 

: a u r p ^ oo0 iha v 乂 

has io dcda，e a [ 00) 

七 Clo-thmgEx^cptioh/ 


TROUBL0 




O rr ( 

；^od two- a. 
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fixing the Sequencer code 


ftettiwg back to our music code 


Now that you’ve completely forgotten, we started this chapter 
with a first look at some JavaSound code. We created a Se¬ 
quencer object but it wouldn’t compile because the method 
Midi.getSequencer() declares a checked exception (MidiUnavail- 
ableException). But we can fix that now by wrapping the call in a 
try/catch. 

public void play() { 

try { 


0 , 




Ho 


)o\t^ 




Y\0^ 
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_ ， 部 
祕 Wo 以 . 


Sequencer sequencer = MidiSystem.getSequencer(); 
System, out .printIn (''Successfully got a sequencer") 


Exception Rules - 

(T\ You cannot have a catch or finally 
without a try 

HOT 


void go() { 

Foo f = new Foo (); 
f . foof (); 

catch(FooException ex) 

} 





} catch(MidiUnavailableException ex) 

System. out. println (''Bummer"); 

} 

// close play 


❻ 卜乂。 r。 〜 l 

C 化:心 ： 



③ A try MUST be followed by either a 
catch or a finally 


try { 

x.doStuff() 

} finally { 

// cleanup 

} 




② You cannot put code between the 
try and the catch 


try 


x.doStuff (); 




int y = 43; 

} catch(Exception ex) 


④ A try with only a finally (no catch) 
must still declare the exception. 

void go() throws FooException { 

try { .,. oVA t a ^ 

x.doStuff () ； A 0 \\ e 

} fmally { } ㈣ 勹丄 
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Code Kitcken 







You don’t kave to do it 
yourseU, Wt it、a lot 
more Jfun iJf you do. 

Tke rest of tkis ckapter 
is optional; you can use 
Heacty-take cocte for all 
tke music apps. 

But if you want to learn 
more aLout JavaSounct, 
turn tke page. 


But why dotVt 


you just 


use 


Ready-bake code? 


There is NO way 
Tm letting Betty win the 
code-off this year, so I’m 
gonna make it myself from 
scratch. 
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JavaSound MIDI classes 


Making actual sound 

Remember near the beginning of the chapter, we looked at how MIDI data holds 
the instructions for what should be played (and how it should be played) and we 
also said that MIDI data doesn’t actually create any sound that you hear. For sound 
to come out of the speakers, the MIDI data has to be sent through some kind of 
MIDI device that takes the MIDI instructions and renders them in sound, either 
by triggering a hardware instrument or a ‘virtual’ instrument (software synthe¬ 
sizer) .In this book, we’re using only software devices, so here’s how it works in 
JavaSound: 


You need FOUR things: 


① The thing that 
plays the music 


plays 

Sequencer - 


The Sequencer is the thing 
that actually causes a song 
to be played.Think of it like 

a music CD player. 


② The music to be 
played...a song. 


has a 

► Sequence - 



The Sequence is the 
song, the musical piece 
that the Sequencer will 
play. For this book, think 
of the Sequence as a 
music CD, but the whole 
CD plays just one song. 





③ The part of the 
Sequence that 
holds the actual 
information 


④ The actual music 
information： 
notes to play, 
how long, etc. 


holds 

Track - 


For this book, we only 
need one Track, so just 
imagine a a music CD 
with only one song. A 
single Track.This Track 
is where all the song 
data (MIDI information) 
lives. 



A MIDI event is a message 
that the Sequencer can 
understand. A MIDI event 




might say (if it spoke 
English),"At this moment 
in time, play middle C, play 
it this fast and this hard, 
and hold it for this long." 

A MIDI event might 
also say something like, 
"Change the current 
instrument to Flute.” 
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exception handling 


And you need FIVE steps: 

① Set a Sequencer and open it 

Sequencer player = MidiSystem.getSequencer(); 
player.open(); 


(2) Make a new Sequence 

Sequence seq = new Sequence(timing,4); 


(s) Get a new Track from the Sequence 

Track t = seq.createTrack(); 


(4) Fill the Track with MidiEvents and 
give the Sequence to the Sequencer 

t.add(myMidiEventl); 
player.setSequence(seq); 



Ahhhh. We 
forgot to push the 
PLAY button. You have to 
start() the Sequencer! 



player. start (); 
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a sound application 


Your very first sound player app 

Type it in and run it. You’ll hear the sound of someone playing a 
single note on a piano! (OK, maybe not someone, but something.) 


import j avax.sound.midi.*; 


w»idi 


P 此 k 巧 


t 


public class MiniMiniMusicApp { 

public static void main(String[] args) { 

MiniMiniMusicApp mini = new MiniMiniMusicApp() 
mini.play(); 

} // close main 

public void play() { 


try 


① 


Sequencer player 
player.open(); 


MidiSystem.getSequencer() 


Sequence seq = new Sequence(Sequence.PPQ, 4); 


Track track = seq.createTrack(); 



④ 



ShortMessage a = new ShortMessage(); 
a.setMessage(144, 1, 44, 100); 

MidiEvent noteOn = new MidiEvent(a, 1); 
track.add(noteOn); 


ShortMessage b = new ShortMessage(); 
b•setMessage(128, 1, 44, 100); 

MidiEvent noteOff = new MidiEvent(b, 16) 
track.add(noteOff); 



二，: r 

Kro — 七 ). 


h thc daia 



ih 


ihc T^rack. 


Put some ih-to -the Tv-a^k. This P av-t 

； S 巧 R 吟 1 . Uy 仏， you ，” 

have io ta>rt about io the 

sci/VIcssagcO method, a"d the io 

■the ^IidiEv Ch -t ^Ohs-tvu^-tov. WeW look ai those 
avgumch-ts oh -the hex-t page. 


player.setSequence(seq) 
player.start(); 


4 - ^ 

catch (Exception ex) { 
ex.printStackTrace() 


(^ - fy\!t Sc<\UCir\£.C *to Sc<\UCir\dC\r (like 

pu-ttmj CP \y\ -the CV playev) 


SUi ° ^ ^ 


饮 （like 


pus “3 PLAy) 


} // close play 

// close class 
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Makmg a MidiEvent (song data) 


A MidiEvent is an instruction for part of a song. A series of MidiEvents is 
kind of like sheet music, or a player piano roll. Most of the MidiEvents we 
care about describe a thing to do and the moment in time to do it. The moment 
in time part matters, since timing is everything in music. This note follows 
this note and so on. And because MidiEvents are so detailed, you have to say 
at what moment to start playing the note (a NOTE ON event) and at what 
moment to stop playing the notes (NOTE OFF event). So you can imagine 
that firing the “stop playing note G” (NOTE OFF message) before the “start 
playing Note G” (NOTE ON) message wouldn’t work. 

The MIDI instruction actually goes into a Message object; the MidiEvent is 
a combination of the Message plus the moment in time when that message 
should ‘fire’. In other words, the Message might say, “Start playing Middle 
C” while the MidiEvent would say, “Trigger this message at beat 4”. 

So we always need a Message and a MidiEvent. 


The Message says what to do, and the MidiEvent says when to do it. 


① Make a Message 

ShortMessage a = new ShortMessage(); 


A MidiEvent 娜豸 
what to do and 
when to do it* 


Every in^tmction 
mu^t include the 
trnung for that 
in^tmction^ 

In other worcfe, at 
which beat that 
thing should happen. 


(2) Put the Instruction in the Message 

a•setMessage(144, 1, 44, 100); 

(§) Make a new MidiEvent using the Message 

MidiEvent noteOn = new MidiEvent(a, 1) 

④ Add the MidiEvent to the Track 

track.add(noteOn); j 




七 hew io c , | o ^ 0 S^ 

^ tbs Plaved - 祕一 
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contents of a Midi event 


MW\ message: the heart of a MidiEvent 

A MIDI message holds the part of the event that says what to do. The actual instruction 
you want the sequencer to execute. The first argument of an instruction is always the type 
of the message.The values you pass to the other three arguments depend on the type of 
message. For example, a message of type 144 means “NOTE ON”. But in order to carry 
out a NOTE ON, the sequencer needs to know a few things. Imagine the sequencer saying, 
“OK, I’ll play a note, but which channel? In other words, do you want me to play a Drum 
note or a Piano note? And which note} Middle-C? D Sharp? And while we’re at it, at which 
velocity should I play the note? 

To make a MIDI message, make a ShortMessage instance and invoke setMessage(), passing 
in the four arguments for the message. But remember, the message says only what to do, so 
you still need to stuff the message into an event that adds when that message should ‘fire’. 


Anatomy of a message 

The first argument to setMessage() always 
represents the message 'type’，while the other 
three arguments represent different things 
depending on the message type. 



a.setMessage(14 4 A 1 , 44, 100); 

-p, ^ —- 、 ^ 

Iss-f ： g 、 

f ° h ^ 



128 means 
NOTE OFF 


144 means 
NOTE ON 


① Message type 


The Message says what to do, the 
MidiEvent says when to do it. 


② Channel 

Think of a channel like a musician in 
a band. Channel 1 is musician 1 (the 
keyboard player), channel 9 is the 
drummer, etc. 


(3) Note to play 


A number from 0 to 127, going 
from low to high notes. 



④ Velocity 

How fast and hard 
you press the key? 0 is so soft you 
probably wont hear anything, but 100 is a 
good default. 
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Change a message 

Now that you know what’s in a Midi message, you can start experimenting. You 
can change the note that’s played, how long the note is held, add more notes, 
and even change the instrument. 


① Change the note 

Try a number between 0 and 127 in the note 
on and note off messages. 

a • setMessage (144, 1, 20, 100); 



② Change the duration of the note 

Change the note off event (not the message) so 
that it happens at an earlier or later beat. 

b.setMessage(128, 1, 44, 100); 
MidiEvent noteOff = new MidiEvent(b. 




③ Change the instrument 

Add a new message, BEFORE the note-playing message, 
that sets the instrument in channel 1 to something other 
than the default piano. The change-instrument message 
is '192', and the third argument represents the actual 
instrument (try a number between 0 and 127) 

first. setMessage (192, i, 102, o); 
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change the instrument and note 

Version 2 : Using commamHiwe args to experiment with sounds 

This version still plays just a single note, but you get to use command-line argu¬ 
ments to change the instrument and note. Experiment by passing in two int values 
from 0 to 127. The first int sets the instrument, the second int sets the note to play. 

import j avax.sound.midi.*; 

public class MiniMusicCmdLine { // this is the first one 

public static void main(String[] args) { 

MiniMusicCmdLine mini = new MiniMusicCmdLine(); 
if (args.length < 2) { 

System. out. print In (''Don A t forget the instrument and note args ’’）； 
} else { 

int instrument = 工 nteger•parselnt(args[0]); 
int note = Integer.parselnt(args[l]); 
mini•play(instrument, note); 

} 

} // close main 

public void play(int instrument, int note) { 


try { 


Sequencer player = MidiSystem.getSequencer(); 
player.open (); 

Sequence seq = new Sequence(Sequence.PPQ, 4); 

Track track = seq.createTrack(); 

MidiEvent event = null; 

ShortMessage first = new ShortMessage (); 
first • setMessage (192, 1, instrument, 0); 

MidiEvent changelnstrument = new MidiEvent (first, 1); 
track.add(changelnstrument); 


ShortMessage a = new ShortMessage(); 
a•setMessage(144, 1, note, 100); 

MidiEvent noteOn = new MidiEvent(a, 1); 
track.add(noteOn); 

ShortMessage b = new ShortMessage(); 
b•setMessage(128, 1, note, 100); 

MidiEvent noteOff = new MidiEvent(b, 16); 
track.add(noteOff); 
player.setSequence(seq); 
player.start(); 


Ruir\ i*t *two m 七 av-gs -fv-om O 
b> izl. T\ry these -fo\r s*ta\rtc\rs ： 



} catch (Exception ex) {ex.printStackTrace();} 
} // close play 

} // close class 
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Bass Drum 
Closed Hi-Hat 
Open Hi-Hat 
Acoustic Snare 
Crash Cymbal 
Hand Clap 
High Tom 
Hi Bongo 
Maracas 
Whistle 


dance beat 
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the rest 


e o e Cyber BeatBox 


Where were headed with 
of the CodeKitchens 

Chapter 15: the goal 

When were done, weII have a working 
BeatBox thafs also a Drum Chat Client. 

We II need to learn about GUIs (includ¬ 
ing event handling), I/O, networking, and 
threads. The next three chapters (12,13, 
and 14) will get us there. 


Chapter 12: MIDI events 

This CodeKitchen lets us build a little 
''music video" (bit of a stretch to call it 
that...) that draws random rectangles to 
the beat of the MIDI music. Well learn 
how to construct and play a lot of MIDI 
events (instead of just a couple, as we do 
in the current chapter). 


e 
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©oe 

■ 






4 








T 



beat 


OY\t 


beat -two 


beat three 


bea*t -four 


Chapter 13: Stand-alone 
BeatBox 

Now we II actually build the real BeatBox, 
GUI and all. But \Ys limited—as soon as you 
change a pattern, the previous one is lost. 
There's no Save and Restore feature, and 
it doesn’t communicate with the network. 
(But you can still use it to work on your 
drum pattern skills.) 
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Chapter 14: Save and 
Restore 

YouVe made the perfect pattern, and 
now you can save it to a file, and reload it 
when you want to play it again. This gets 
us ready for the final version (chapter 15), 
where instead of writing the pattern to a 
file, we send it over a network to the chat 
server. 
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exercise: True or False 


This chapter explored the wonderful world of 
exceptions. Your job is to decide whether each of the 
following exception-related statements is true or false. 

ok Fawe^ 

1. A try block must be followed by a catch and a finally block. 

2. If you write a method that might cause a compiler-checked exception, you 
must wrap that risky code in a try / catch block. 

3. Catch blocks can be polymorphic. 

4. Only ‘compiler checked’ exceptions can be caught. 

5. If you define a try / catch block, a matching finally block is optional. 

6. If you define a try block, you can pair it with a matching catch or finally block, 
or both. 

7. If you write a method that declares that it can throw a compiler-checked ex¬ 
ception, you must also wrap the exception throwing code in a try / catch block. 

8. The main( ) method in your program must handle all unhandled exceptions 
thrown to it. 

9. A single try block can have many different catch blocks. 

10. A method can only throw one kind of exception. 

11. A finally block will run regardless of whether an exception is thrown. 

12. A finally block can exist without a try block. 

13. A try block can exist by itself, without a catch block or a finally block. 

14. Handling an exception is sometimes referred to as ‘ducking’. 

15. The order of catch blocks never matters. 

16. A method with a try block and a finally block, can optionally declare the 
exception. 

17. Runtime exceptions must be handled or declared. 
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Code Magnets 

A working Java program is scrambled up on the fridge. Can you 
reconstruct all the code snippets to make a working Java program 
that produces the output listed below? Some of the curly braces fell 
on the floor and they were too small to pick up, so feel free to add as 
many of those as you need! 


File Edit Window Help Throwllp 


% java ExTestDrive yes 
thaws 

% java ExTestDrive no 
throws 



class MyEx extends Exception { } 


public class ExTestDrive { 



static void doRisky(String t) throws MyEx { 
System.out.print(); 


public static void main 
String test = args[0]; 


(String [] args) { 
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puzzle: crossword 


JavaO 娜 7.0 



1 

2 


3 








4 







5 













6 






7 



8 

















9 

10 

11 





12 






13 



























14 


15 






16 


















17 



18 






19 














20 







21 


22 









23 


24 









25 













26 











27 






28 


















29 




You know what to do! 


Across 

1. To give value 
4. Flew off the top 
6. All this and more! 
8. Start 

10. The family tree 
13. No ducking 
15. Problem objects 
18. One of Java's W 


20. Class hierarchy 

21. Too hot to handle 

24. Common primitive 

25. Code recipe 

27. Unruly method action 

28. No Picasso here 

29. Start a chain of events 


Down 

2. Currently usable 

3. Template's creation 

4. Don’t show the kids 

5. Mostly static API class 

7. Not about behavior 

9. The template 

11. Roll another one off 
the line 


12. Javac saw it coming 
14. Attempt risk 

16. Automatic acquisition 

17. Changing method 
19. Announce a duck 

22. Deal with it 

23. Create bad news 

26. One of my roles 


More Hints: … s^qu^N s 

,J 0 H 06 , bion 'Li ( 0 |dUUBX 0 iou) JOJ '£ 

0UniJOj AljLUBj 0L|1 - 9L L|SBML|inOLU B JO 'Z 

lineup jo Dj|qnd A|uq '6 umoq 


peJisqviON -8 乙 
LU0|qojd e sueis ■ LZ 
>peno •[_ 乙 

uo!P 0 ||OD p adAi e os|\/ '0Z 


ajepapp peaisui ■£[ 
poL|i0iu e ueis - 8 

pilLjDBAerv -9 

SSOJDV 
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E^eicise Solutions 


Tw FaLs 彡 

1. False, either or both. 

2. False, you can declare the exception. 

3. True. 

4. False, runtime exception can be caught. 

5. True. 

6. True, both are acceptable. 

7. False, the declaration is sufficient. 

8. False, but if it doesn’t the JVM may shut 
down. 

9. True. 

10. False. 

11. True. It’s often used to clean-up partially 
completed tasks. 

12. False. 

13. False. 

14. False, ducking is synonomous with declar¬ 
ing- 

15. False, broadest exceptions must be caught 
by the last catch blocks. 

16. False, if you don’t have a catch block, you 
must declare. 

17. False. 


Code Magnets 

class MyEx extends Exception { } 

public class ExTestDrive { 

public static void main(String [] args) { 
String test = args[0]; 
try { 

System.out.print("t"); 
doRisky(test); 

System.out.print( "o "); 

} catch ( MyEx e) { 

System.out•print("a"); 

} finally { 

System.out.print("w ”）； 

} 

System, out .print In (); 

} 

static void doRisky(String t) throws MyEx { 
System, out .print (); 

if ("yes”.equals(t)) { 

throw new MyEx(); 

} 

System, out .print (); 

} _ 

} I File Edit Window Help Chill 


% java ExTestDrive yes 
thaws 

% java ExTestDrive no 
throws 
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12 getting gui 



I heard your 


A Very Graphic 
Story 


Wow! This looks great 


I guess presentation 


really is everything. 


Face it, you need to make GUIs. If you’re building applications that other 
people are going to use, you need a graphical interface. If you’re building programs for yourself, 
you want a graphical interface. Even if you believe that the rest of your natural life will be 
spent writing server-side code, where the client user interface is a web page, sooner or later 
you’ll need to write tools, and you’ll want a graphical interface. Sure, command-line apps are 


retro, but not in a good way.They’re weak, inflexible, and unfriendly. We'll spend two chapters 
working on GUIs, and learn key Java language features along the way including Event 
Handling and Inner Classes. In this chapter, we’ll put a button on the screen, and make it do 
something when you click it. We’ll paint on the screen, we’ll display a jpeg image, and we’ll even 


do some animation. 
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your first gui 


It all starts with a window 

AJFrame is the object that represents 
a window on the screen. It’s where you 
put all the interface things like buttons, 
checkboxes, text fields, and so on. It can 
have an honest-to-goodness menu bar 
with menu items. And it has all the little 
windowing icons for whatever platform 
you’re on, for minimizing, maximizing, and 
closing the window. 

The JFrame looks different depending on 
the platform you’re on. This is a JFrame on 
Mac OS X: 


“If ■ see one more 



command-line app ， 
you’re fired ■” 



Put widgets w the window 



Making a GUI is easy: 

① Make a frame (a JFrame) 

JFrame frame = new JFrame(); 

② Make a widget (button, text field, etc.) 

JButton button = new JButton (''click me 


Once you have a JFrame, you can put 
things (‘widgets’）in it by adding them 
to the JFrame. There are a ton of Swing 
components you can add; look for them 
in the javax.swing package. The most 
common include JButton, JRadioButton, 
JCheckBox, JLabel, JList, JScrollPane, 
JSlider ， JTextArea, JTextField，and 
JTable. Most are really simple to use, but 
some (like JTable) can be a bit more 
complicated. 


( 3 ) Add the widget to the frame 

frame.getContentPane().add(button) 


④ Display it (give it a size and make it visible) 

frame.setSize(300,300); 
frame.setVisible(true); 
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Your first &UI: a button oh a frame 

Aor^i io 

import javax. swing.*; SY/m ^ ? adkay 


public class SimpleGuil { 

public static void main (String[] args) { 


JFrame frame = new JFrame(); 



aVe a 




av\A a 


(\JO\A \>ass 


\)Jc^ 

払 c button do 怕七 vudW 


JButton button = new JBut ton (''click me ’’）； 七七 e% 七 Y oU v ^ v ' 七 0 灼 


七 V^C 


oi\J 


frame. setDefaultCloseOperation (JFrame. EXIT—ON—CLOSE); 

^ ’ — as y<^ 

ius-fe si4- 4-lx 丄 1 / y otl ou*t i 七 will 

frame.getContentPane () .add(button) ; Jit theme oh the s£v~eeh -Povcvcv) 


frame.setSize(300,300); 


frame.setVisible(true); 




P^hC 


3, 鳴 S( 


^ pixe/s 




Let’s see what happens when we run it: 

% java SimpleGuil 



她 oa! That’s a 
Really Big Button. 

The button fills all the 
available space in the frame 
Later we II learn to control 
where (and how big) the 
button is on the frame. 
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user interface events 


Put nothing happens when I click it... 

That’s not exactly true. When you press the button it shows that 
‘pressed’ or ‘pushed in’ look (which changes depending on the 
platform look and feel, but it always does something to show when 
it’s being pressed). 

The real question is, “How do I get the button to do something 
specific when the user clicks it?” 


We need two things: 

① a method to be called when the user 
clicks (the thing you want to happen as 
a result of the button click). 

® A way to knoiV when to trigger 
that method. In other words, a way 
to know when the user clicks the 
button! 



to know. 


We’re interested in the user- 
takes-action-on-a-button event. 



Will a button look like a 
Windows button when you run on 
Windows? 

If you want it to. You can 
choose from a few "look and 
feels" — classes in the core library 
that control what the interface looks 
like. In most cases you can choose 
between at least two different looks: 
the standard Java look and feel, also 
known as Metal, and the native look 
and feel for your platform.The Mac 
OS X screens in this book use either 
the OS X Aqua look and feel, or the 
Metal look and feel. 

Can I make a program look 
like Aqua all the time? Even when 
it's running under Windows? 

Nope. Not all look and feels 
are available on every platform. If 
you want to be safe, you can either 
explicitly set the look and feel to 
Metal, so that you know exactly what 
you get regardless of where the app 
is running, or don’t specify a look 
and feel and accept the defaults. 

I heard Swing was dog-slow 
and that nobody uses it. 

This was true in the past, 
but isn’t a given anymore. On weak 
machines, you might feel the pain of 
Swing. But on the newer desktops, 
and with Java version 1.3 and be¬ 
yond, you might not even notice the 
difference between a Swing GUI and 
a native GUI. Swing is used heavily 
today, in all sorts of applications. 
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&Gttmg a user event 

Imagine you want the text on the button to 
change from click me to I’ve been clicked when 
the user presses the button. First we can write a 
method that changes the text of the button (a 
quick look through the API will show you the 
method): 


public void changelt() { 

button. setText (''I A ve been clicked!"); 

} 

But now what? How will we know when this 
method should run? How will we know when the 
button is clicked? 


In Java, the process of getting and handling a 
user event is called event-handling. There are 
many different event types in Java, although 
most involve GUI user actions. If the user clicks 
a button, that’s an event. An event that says 
“The user wants the action of this button to 
happen.” If it’s a “Slow Tempo” button, the user 
wants the slow-tempo action to occur. If it’s a 
Send button on a chat client, the user wants the 
send-my-message action to happen. So the most 
straightforward event is when the user clicked 
the button, indicating they want an action to 
occur. 

With buttons, you usually don’t care about any 
intermediate events like button-is-being-pressed 
and button-is-being-released. What you want to 
say to the button is, U I don’t care how the user 
plays with the button, how long they hold the 
mouse over it, how many times they change their 
mind and roll off before letting go, Just tell 
me when the user means business! In other words, 
don’t call me unless the user clicks in a way that 
indicates he wants the darn button to do what it 
says it’ll do!” 


First, the button needs to know 
that we care. 


① 


Hey W 七七 。灼 ，丨 abou*t 

▲ 七 ⑼ s to you. 




Second, the button needs a way 
to call us back when a button- 
clicked event occurs. 





1) How could you tell a button object that you 
care about its events? That you’re a concerned 
listener? 


2) How will the button call you back? Assume 
that there’s no way for you to tell the button the 
name of your unique method (changeltO). So 
what else can we use to reassure the button that 
we have a specific method it can call when the 
event happens? [hint: think Pet] 
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event listeners 


If you care about the button’s events, 


implement an interface 

‘Tm 

listening 

for your events 


A listener interface is the bridge between the 
listener (you) and event source (the button). 


The Swing GUI components are event sources. In Java terms, 
an event source is an object that can turn user actions (click 
a mouse, type a key, close a window) into events. And like 
virtually everything else in Java, an event is represented as an 
object. An object of some event class. If you scan through the 
java.awt.event package in the API, you’ll see a bunch of event 
classes (easy to spot — they all have Event in the name). You’ll 
find MouseEvent, KeyEvent, WindowEvent, ActionEvent, and 
several others. 

An event source (like a button) creates an event object when the 
user does something that matters (like click the button). Most 
of the code you write (and all the code in this book) will receive 
events rather than create events. In other words, you’ll spend 
most of your time as an event listener rather than an event source. 

Every event type has a matching listener interface. If you want 
MouseEvents, implement the MouseListener interface. Want 
WindowEvents? Implement WindowListener. You get the idea. 
And remember your interface rules — to implement an interface 
you declare that you implement it (class Dog implements Pet), 
which means you must write implementation methods for every 
method in the interface. 

Some interfaces have more than one method because the 
event itself comes in different flavors. If you implement 
MouseListener, for example, you can get events for 
mousePressed, mouseReleased, mouseMoved, etc. Each of 
those mouse events has a separate method in the interface, 
even though they all take a MouseEvent. If you implement 
MouseListener, the mousePressed() method is called when the 
user (you guessed it) presses the mouse. And when the user lets 
go, the mouseReleased() method is called. So for mouse events, 
there’s only one event object, MouseEvent, but several different 
event methods, representing the different types of mouse events. 


她 en you implement a 
listener interface, you give 
ike button a way to call 
you back. The interface is 
>^iere ihe ealH>aet method 
is declared. 
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How the listener and source 
communicate: 





Qc tio 卟 e rformedC^ 0 ^ 


Tke Listener 


t 


If your class wants to know about 
a button's ActionEvents,you 
implement the ActionListener 
interface.The button needs to 
know you're interested, so you 
register with the button by calling its 
addActionListener(this) and passing an 
ActionListener reference to it (in this case, 
you are the ActionListener so you pass 
f/?/s).The button needs a way to call you 
back when the event happens, so it calls 
the method in the listener interface. As an 
ActionListener, you masf implement the 
interface’s sole method, actionPerformedO. 
The compiler guarantees it. 


'OK, you're an ActionListener, 
so I know how to call you back 
when there's an event — ril call 
the actionPerformedO method 
that I know you have." 




Tke Event Source 

A button is a source of Action Events, 
so it has to know which objects are 
interested listeners.The button has an 
addActionListener() method to give 
interested objects (listeners) a way to 
fe//the button they’re interested. 

When the button’s 
addActionListener() runs (because 
a potential listener invoked it), the 
button takes the parameter (a 
reference to the listener object) and 
stores it in a list. When the user clicks 
the button, the button'fires’the event 
by calling the actionPerformedO 
method on each listener in the list. 
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Getting a button’s ActionEvent 

① Implement the ActionListener interface 

② Register with the button (tell it you 
want to listen for events) 

③ Define the event-handling method (implement 
the actionPerformed() method from the 
ActionListener interrface) 


import javax.swing.*; 
import java.awt.event. 


① K 

public class SimpleGuilB implements ActionListener { 
JButton button; 

public static void main (String[] args) { 
SimpleGuilB gui = new SimpleGuilB(); 
gui.go(); 

} 






y— 




并 '^ ) 


TV ' S ^ 


② button. addActionListener (this); 

厂 l_ - - -e=> 


public void go () { 

JFrame frame = new JFrame(); 

button = new JButton (''click me") ; ■、 

cC; 二工 : a 

frame.getContentPane().add(button); 

frame. setDefaultCloseOperation (JFrame. EXIT_ON_CLOSE) ; , 

frame.setSize (300,300); WP ■ 、 

— e 七二沭 r “ 

public void actionPerformed(ActionEvent event) { 
button.setText(、T ve been clicked!"); 


frame.setVisible(true); 



^ °； ca V his ^ hod w y- 

T i r ds you ah 細 。“ W 

bu-t WC do^i hccd jl △ . i °° U 

i S , h ▲ ^7 七 w 


^ the 
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Listeners, Sources, and Events 


For most of your stellar Java career, you will not be the source 
of events. 

(No matter how much you fancy yourself the center of your social 
universe.) 

Get used to it. Your job is to be a good listener. 

(Which, if you do it sincerely, can improve your social life.) 


As a listener, my job is to 
implement the interface, 
register with the button, and 
provide the event-handling. 


As an event source, my job is to 
accept registrations (from listeners), 
get events from the user, and 
call the listeners event-handling 
method (when the user clicks me) 



Listener GETS the 
^ event 




Source SENDS 
the event 



Hey, what about me? I*m a player too, you 
know! As an event object, I’m the argument 


to the event call-back method (from the 
interface) and my job is to carr 

the event back to the listener. 


data about 





Event object 
HOLDS DATA 
about the event 
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ffcereiEirejiP 

Dumb Questions 


Why can’t ■ be a source of events? 


A. 

You CAN. We just said that most of the time 
you’ll be the receiver and not the originator of the 
event (at least in the early days of your brilliant Java 
career). Most of the events you might care about 
are 'fired' by classes in the Java API, and all you have 
to do is be a listener for them. You might, however, 
design a program where you need a custom event, say, 
StockMarketEvent thrown when your stock market 
watcher app finds something it deems important. In 
that case, you’d make the StockWatcher object be an 
event source, and you’d do the same things a button 
(or any other source) does — make a listener interface 
for your custom event, provide a registration method 
(addStockListenerO), and when somebody calls it, add 
the caller (a listener) to the list of listeners.Then, when 
a stock event happens, instantiate a StockEvent object 
(another class you’ll write) and send it to the listeners 
in your list by calling their stockChanged(StockEvent 
ev) method. And don’t forget that for every event type 
there must be a matching listener interface (so you’ll 
create a StockListener interface with a stockChangedO 
method). 


I don’t see the importance of the event object 
that’s passed to the event call-back methods. If 
somebody calls my mousePressed method, what 
other info would I need? 

A lot of the time, for most designs, you don’t 
need the event object. It's nothing more than a little 
data carrier, to send along more info about the event. 
But sometimes you might need to query the event for 
specific details about the event. For example, if your 
mousePressedO method is called, you know the mouse 
was pressed. But what if you want to know exactly 
where the mouse was pressed? In other words, what if 
you want to know the X and Y screen coordinates for 
where the mouse was pressed? 

Or sometimes you might want to register the same 
listener with multiple objects. An onscreen calculator, 
for example, has 10 numeric keys and since they all do 
the same thing, you might not want to make a separate 
listener for every single key. Instead, you might 
register a single listener with each of the 10 keys, and 
when you get an event (because your event call-back 
method is called) you can call a method on the event 
object to find out who the real event source was. In 
other words, which key sent this event. 


-ct^lharpen your penci 

F^rh nf thp<;p 


Each of these widgets (user interface objects) are the 


source of one or more events. Match the widgets with 
the events they might cause. Some widgets might be a 
source of more than one event, and some events can be 
generated by more than one widget. 

Widgets 

Event methods 

check box 

windowClosing() 

text field 

actionPerformed() 

scrolling list 

itemStateChanged() 

button 

mousePressedO 

dialog box 

keyTyped() 

radio button 

mouseExited() 

menu item 

focusGained() 


How do you KNOW if 
an object is an event 
Source? 

Look in the API. 

OK. Look for 

A method that starts with 
‘add’，ends with listener’, 
and takes a listener inter¬ 
face argument. If you see: 

addKeyListener(KeyListener k) 

you know that a class 
with this method is a 
source of KeyEvents. 
There’s a naming pattern. 
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ftettiwg back to graphics... 

Now that we know a little about how events work (we’ll learn 
more later), let’s get back to putting stuff on the screen. 
We’ll spend a few minutes playing with some fun ways to get 
graphic, before returning to event handling. 

Three ways to put things on your GUI: 

① Put widgets on a frame 

Add buttons, menus, radio buttons, etc. 
frame.getContentPane().add(myButton); 

The javax.swing package has more than a dozen 
widget types. 



② Draw 2D graphics on a widget 

Use a graphics object to paint shapes, 
graphics .fillOval (70,70,100,100); 

You can paint a lot more than boxes and circles; 
the Java2D API is full of fun, sophisticated 
graphics methods. 





③ Put a JPEG on a widget 

You can put your own images on a widget. 

graphics.drawlmage(myPic,10,10,this); 
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making a drawing panel 


Make your oww drawing widget 


If you want to put your own graphics on the screen, your best 
bet is to make your own paintable widget. You plop that widget 
on the frame, just like a button or any other widget, but when it 
shows up it will have your images on it. You can even make those 
images move, in an animation, or make the colors on the screen 
change every time you click a button. 

It’s a piece of cake. 

Make a subclass of JPanel and override one 
method, paintComponent(). 

All of your graphics code goes inside the paintComponent() 
method. Think of the paintComponent() method as the method 
called by the system to say, “Hey widget, time to paint yourself.” 

If you want to draw a circle, the paintComponent() method will 
have code for drawing a circle. When the frame holding your 
drawing panel is displayed, paintComponent() is called and your 
circle appears. If the user iconifies/minimizes the window, the 
JVM knows the frame needs “repair” when it gets de-iconified, 
so it calls paintComponent() again. Anytime the JVM thinks the 
display needs refreshing, your paintComponent () method will be 
called. 



One more thing, you never call this method yourself! The argument 
to this method (a Graphics object) is the actual drawing canvas 
that gets slapped onto the real display. You can’t get this by 
yourself; it must be handed to you by the system. You’ll see 
later, however, that you can ask the system to refresh the display 
(repaint()), which ultimately leads to paintComponent() being 


called. 


import java.awt.*; 


import javax.swing.*; ^ 
class MyDrawPane1 extends JPanel { 




\\Yt 




* 




public void paintComponent (Graphics g) { y oVA ^\\\ a ^ 


g.setColor(Color.orange); 


hdllhQ §4" ^ 


^ ^ ?d ' 


or\ 灼 0 屮 . 


g.fillRect(20,50,100,100); 七二 = 仏 3 / 0 uV c 


shape io M ^ Wiih 



364 





getting gui 


Fuw thmgs to do m pamtCompoHeHtO 

Let’s look at a few more things you can do in paintComponent (). 
The most fun, though, is when you start experimenting yourself. 
Try playing with the numbers, and check the API for class 
Graphics (later we’ll see that there’s even more you can do besides 
what’s in the Graphics class). 


Display a JPEG 


public void paintComponent(Graphics g) { 









\\tct 


Image image = new Imagelcon (' 、 catzilia, jpg") .getlmage (); 

- 一 ， —^ 

g • drawlmage (image ,3,4, this); 




Th c 




^rchrmc. 



Paint a randomly-colored circle 
on a black background 


public void paintComponent(Graphics g) 








g.fillRect (0,0, this • getWidth () , this .getHeight () ) ; 7 -, n.,. . 

starts, so O, O r ， ca hS sia^i O pixels ^ iUc 


int red = (int) (Math.random() * 255); 
int green = (int) (Math.random() * 255); 
int blue = (int) (Math.random() * 255); 

Color randomColor = new Color(red, green, blue) 
g.setColor(randomColor); 
g.fillOval (70,70,100,100); 


成 s: 為紙， 


1 <七 ad O pixels ^v-om the top " The 


akc 託 as taiu the pad 



Y ou a 1 


4L, ,h9 ih 3 ^ 
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drawing gradients with Graphics2D 

Pehmd every good Graphics reference 
is a &raphics2g object. 

The argument to paintComponent() is declared as type 
Graphics (java.awt.Graphics). 


public void paintComponent(Graphics g) { } 

So the parameter ‘g’ IS-A Graphics object. Which means it 
could be a subclass of Graphics (because of polymorphism). 

And in fact, it is. 

The object referenced by the ‘g’ parameter is actually an 
instance of the Graphics2D class. 

Why do you care? Because there are things you can do with 
a Graphics2D reference that you can’t do with a Graphics 
reference. A Graphics2D object can do more than a Graphics 
object, and it really is a Graphics2D object lurking behind the 
Graphics reference. 

Remember your polymorphism. The compiler decides which 
methods you can call based on the reference type, not the 
object type. If you have a Dog object referenced by an Animal 
reference variable: 

Animal a = new Dog(); 

You can NOT say: 

a.bark(); 

Even though you know it’s really a Dog back there. The 
compiler looks at ‘a’，sees that it’s of type Animal, and finds 
that there’s no remote control button for bark() in the Animal 
class. But you can still get the object back to the Dog it really is 
by saying: 

Dog d = (Dog) a; 
d.bark(); 

So the bottom line with the Graphics object is this: 

If you need to use a method from the Graphics2D class, you 
can’t use the the paintComponent parameter (‘g’）straight 
from the method. But you can cast it with a new Graphics2D 
variable. 

Graphics2D g2d = (Graphics2D) g; 


Methods you can call on a 
Graphics reference: 

drawlmage() 

drawLine() 

drawPolygon 

drawRect() 

drawOval() 

fillRect() 

fillRoundRect() 

setColor() 

To cast the Graphics2D object to 
a Graphics2D reference: 

Graphics2D g2d = (Graphics2D) g; 

Methods you can call on 
a Graphics2D reference: 

fill3DRect() 

draw3DRect() 

rotate() 

scale() 

shear() 

transform() 

setRenderingHints() 

(these avc r\o*t Complete method lists, 
dhcdk API more) 
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because life's too short to paint the 
circle a solid color when there's a 
gradient blend waiting for you. 



-气 a 鱗 




public void paintComponent(Graphics g) { 


vt’ 


Graphics2D g2d = (Graphics2D) g; 


i*t so y/c 匕扣 ddll 

^v-aphidsZD has bu-t ^vafhids does〆 七 


GradientPaint gradient = new GradientPaint(70,70,Color.blue, 150,150, Color.orange ); 




~"this sc-ts -the 

g2d.setPaint(gradient) 


; 


g2d.fillOval (70,70,100,100); 

^^ vo V ： 、 Jwv \S 


^\W 




public void paintComponent(Graphics g) { 

Graphics2D g2d = (Graphics2D) g; 

int red = (int) (Math.random() * 255); 
int green = (int) (Math.random() * 255); 
int blue = (int) (Math.random() * 255); 

Color startColor = new Color(red, green, blue); 

red = (int) (Math.random() * 255); 
green = (int) (Math.random() * 255); 
blue = (int) (Math.random() * 255); 

Color endColor = new Color(red, green, blue); 




\}\t 


七.丁 1 


GradientPaint gradient = new GradientPaint(70,70,startColor, 150,150, endColor); 
g2d.setPaint(gradient); 
g2d.fillOval (70,70,100,100); 
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BULLET POINT 



- EVENTS - 

■ To make a GUI, start with a window, usually a JFrame 

JFrame frame = new JFrame(); 

■ You can add widgets (buttons, text fields, etc.) to the 
JFrame using: 

frame.getContentPane().add(button); 

■ Unlike most other components, the JFrame doesn’t let 
you add to it directly, so you must add to the JFrame’s 
content pane. 

■ To make the window (JFrame) display, you must give it 
a size and tell it be visible: 

frame.setSize(300,300); 
frame.setVisible(true); 

■ To know when the user clicks a button (or takes some 
other action on the user interface) you need to listen for 
a GUI event. 

■ To listen for an event, you must register your interest 
with an event source. An event source is the thing (but¬ 
ton, checkbox, etc.) that ‘fires’ an event based on user 
interaction. 

■ The listener interface gives the event source a way 
to call you back, because the interface defines the 
method(s) the event source will call when an event 
happens. 

■ To register for events with a source, call the source’s 
registration method. Registration methods always take 
the form of: add<EventType>Listener. To register for a 
button's ActionEvents, for example, call: 

button.addActionLis tener(this); 

■ Implement the listener interface by implementing all of 
the interface’s event-handling methods. Put your event¬ 
handling code in the listener call-back method. For 
ActionEvents, the method is: 

public void actionPerformed (ActionEvent 

event) { 

button. setText (''you clicked! 〃）； 

} 

■ The event object passed into the event-handler method 
carries information about the event, including the source 
of the event. 


- GRAPHICS - 

■ You can draw 2D graphics directly on to a widget. 

■ You can draw a .gif or .jpeg directly on to a widget. 

■ To draw your own graphics (including a .gif or .jpeg), 
make a subclass of JPanel and override the paintCom- 
ponent() method. 

■ The paintComponent() method is called by the GUI 
system. YOU NEVER CALL IT YOURSELF. The argu¬ 
ment to paintComponent() is a Graphics object that 
gives you a surface to draw on, which will end up on 
the screen. You cannot construct that object yourself. 

■ Typical methods to call on a Graphics object (the paint- 
Component paramenter) are: 

graphics.setColor(Color.blue); 
g.fillRect(20,50,100,120> ; 

■ To draw a .jpg, construct an Image using: 

Image image = new Imagelcon (''catzilla. 
jpg" 〉 •getImage(); 

and draw the imagine using: 

g.drawlmage(image,3,4,this); 

■ The object referenced by the Graphics parameter 
to paintComponent() is actually an instance of the 
Graphics2D class. The Graphics 2D class has a variety 
of methods including: 

fill3DRect(), draw3DRect(), rotate(), scale。, shear(), 
transform() 

■ To invoke the Graphics2D methods, you must cast the 
parameter from a Graphics object to a Graphics2D 
object: 

Graphics2D g2d = (Graphics2D) g; 
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Wc can get an event. 

We can paint graphics. 

Put can we paint graphics when m get an event? 

Let’s hook up an event to a change in our drawing panel. We’ll make the circle 
change colors each time you click the button. Here’s how the program flows: 


Start the app 

The frame is built with the two widgets 
(your drawing panel and a button). A 
listener is created and registered with 
the button. Then the frame is displayed 
and it just waits for the user to click. 




The user clicks the button and the 
button creates an event object and 
calls the listeners event handler. 


The event handler calls repaint。on the 
frame. The system calls paintComponent() 
on the drawing panel. 



o Voila! A new color is painted because 
paintComponent() runs again, filling the 
circle with a random color. 
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building a GUI frame 






&U1 layouts: putting more thaw owe 
widget on a frame 

We cover GUI layouts in the next chapter, but we’ll do a 
quickie lesson here to get you going. By default, a frame 
has five regions you can add to. You can add only one thing 
to each region of a frame, but don’t panic! That one thing 
might be a panel that holds three other things including a 
panel that holds two more things and... you get the idea. In 
fact, we were ‘cheating’ when we added a button to the frame 


using: 




frame.getContentPane().add(button); 

丁 欠 

\a/V\ 6.R.^ frame . getContentPane () . add (BorderLayout. CENTER, button); 

,\dyt to ad d 

' a : x 


w 








1 


y/cs*t 

- - 




v~cgioh. 


east 


sou*th 




— C^^rpen your pencil — 

Given the pictures on page 351, write the 
code that adds the button and the panel to 
the frame. 
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The circle changes color each time you 
click the button. 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 


public class SimpleGui3C implements ActionListener 


JFrame frame; 



public static void main (String[] args) 
SimpleGui3C gui = new SimpleGui3C(); 
gui.go(); 




public void go () { 

frame = new JFrame(); 

frame.setDefaultCloseOperation(JFrame.EXIT ON CLOSE) 


JButton button = new JButton (''Change colors") 
button.addActionListener(this); ^_ 


\\sU^ r 




CtW 、 s) 


MyDrawPane1 drawPanel = new MyDrawPanel(); 

frame.getContentPane().add(BorderLayout.SOUTH, 
frame.getContentPane().add(BorderLayout.CENTER, 
frame.setSize(300,300); 


十 。 一 3 士 ( U 一 

button” d^wih 3 P 如 IUo 

drawPanel) ; ^ the two v*cgiohs of 


frame.setVisible(true); 


public void actionPerformed(ActionEvent event) { 
frame.repaint(); 

} 工穴 

\七 。 々。二 S 、“細叫 


class MyDrawPanel extends JPanel { 

public void paintComponent(Graphics g) { 

// Code to fill the oval with a random color 
// See page 347 for the code 


Zks od ,s ^ iicd 
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Let's try it with TWO buttons 

The south button will act as it does now, simply calling repaint on the 
frame. The second button (which we’ll stick in the east region) will 
change the text on a label. (A label is just text on the screen.) 

So wow m need FOUR widgets 




the 


And we need to get 
TWO GVGWtS 

Uh-oh. 

Is that even possible? How do 
you get two events when you 
have only one actionPerformed () 
method? 

TVis button 

ov\ 七 he opposite side 
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How do you get action events for two different buttons, 
when each button needs to do something different? 


getting gui 


① option one 

Implement two actionPerformed() methods 

class MyGui implements ActionListener { 

// lots of code here and then : 

public void actionPerformed(ActionEvent event) { 

frame • repaint (); ^ But this is impossible/ 

} 〆 

public void actionPerformed(ActionEvent event) { 
label. setText (''That hurt!"); 


Flaw: You can’t! You can’t implement the same method twice in a Java class. It won’t compile. 
And even if you could, how would the event source know which of the two methods to call? 


② option two 

Register the same listener with both buttons. 


class MyGui implements ActionListener { 

// declare a bunch of instance variables here 


public void go() { 
// build gui 


colorButton = new JButton(); 
labelButton = new JButton(); 
colorButton.addActionLis tener(this); 
labelButton.addAc tionLis tener(this); 
// more gui code here ... 


^7 S 


stcir "the sdme lis'tchcv* 
both bu-t-tohs 


public void actionPerformed(ActionEvent event) { 
if (event.getSource() == colorButton) { 

frame. repaint () ; _ 

} else { 

label. setText (''That hurt!"); 


Flaw: this does work，but in most cases it’s not very OO. One event handler 
doing many different things means that you have a single method doing many different things. 
If you need to change how one source is handled, you have to mess with everybody's event 
handler. Sometimes it is a good solution, but usually it hurts maintainability and extensibility. 
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How do you get action events for two different buttons, 
whew each button needs to do something different? 


③ option three 

Create two separate ActionListener classes 

class MyGui { 

JFrame frame; 

JLabel label; 
void gui() { 

// code to instantiate the two listeners and register one 
// with the color button and the other with the label button 

} 

} // close class 


class ColorButtonListener implements ActionListener { 
public void actionPerformed(ActionEvent event) { 
frame.repaint(); 

, } \ y/ork! TW,S dlass \iavc a to 

七 'Ivamc vav-'iablc o( tlass 


class LabelButtonListener implements ActionListener { 
public void actionPerformed(ActionEvent event) { 
label. setText (''That hurt! 〃）； 

} 弋 Phobic J This class has r>o io ihc variable ( lab c r 


Flaw: these classes won’t have access to the variables they need 

to act on, *frame 5 and Mabel 9 . You could fix it, but you’d have to give each of the 
listener classes a reference to the main GUI class, so that inside the actionPerformedO 
methods the listener could use the GUI class reference to access the variables of the GUI 
class. But that’s breaking encapsulation, so we’d probably need to make getter methods 
for the gui widgets (getFrameO, getLabelO, etc). And you’d probably need to add a 
constructor to the listener class so that you can pass the GUI reference to the listener at 
the time the listener is instantiated. And, well, it gets messier and more complicated. 

There has got to be a better way! 
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Wouldn't it be wonderful if you 
could have two different listener classes, 
but the listener classes could access the 
instance variables of the main GUI class, 
almost as if the listener classes belonged 
to the other class. Then youd have the best 
of both worlds. Yeah, that would be dreamy. 
But it’s just a fantasy... 
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Inner class to the rescue! 

You can have one class nested inside another. It’s easy. 
Just make sure that the definition for the inner class is 
inside the curly braces of the outer class. 


Simple inner class: 


class MyOuterClass { 

class MylnnerClass { 
void go () { 

} 

} 




An inner class gets a special pass to use the outer class’s stuff. Even 
the private stuff. And the inner class can use those private variables 
and methods of the outer class as if the variables and members 
were defined in the inner class. That’s what’s so handy about inner 
classes — they have most of the benefits of a normal class, but with 
special access rights. 


An inner class can 
use all tke metkocts 
and variables ol tke 
outer class，even tke 
private ones. 

Tke inner class gets 
to use tkose variables 
and metkocts just 
as iJf tke metliocis 
and variables were 
Jeclarect witkin tke 
inner class. 


Inner class using an outer class variable 

class MyOuterClass { 
private int x; 


class MylnnerClass { 
void go () { 

x = 42; ^ — ^ 


usc 'W as ^ ^ a 讓 ， aWc 

山 ss . 


} // close inner class 


} // close outer class 
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Ah mwer class mstance must be tied to 

m outer class mstawee*. 

^ —。 

Remember, when we talk about an inner class accessing 
something in the outer class, we’re really talking about an 
instance of the inner class accessing something in an instance of 
the outer class. But which instance? 


An inner object 
shares a special 
bond with an 
outer object. ^ 


Can any arbitrary instance of the inner class access the methods 
and variables of any instance of the outer class? No! 

Ar). itifipr nhwrt hp tiprl tn n ^bprirfir mifpr nhwrt nfi 


0V e 


r65, 


coP ie ! 






66 




new 


The I” “ 神 0 

author of 




① Make an instance of 
the outer class 



^Oater 


② Make an instance of 
the inner class, by 
usingThe instance 
of the outer class. 



in&c 


① The outer and inner objects 
are now intimately linked. 


TV>csc t^<> 

二 t 举， s 

Ud 讹 da’. 





*There’s an exception to this, for a very special case — an inner class defined 
within a static method. But we’re not going there, and you might go your entire 
Java life without ever encountering one of these. 
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How to make an mstance of an mner class 


If you instantiate an inner class from code within an outer class, the instance 
of the outer class is the one that the inner object will ‘bond’ with. For 
example, if code within a method instantiates the inner class, the inner 
object will bond to the instance whose method is running. 

Code in an outer class can instantiate one of its own inner classes, in exactly 
the same way it instantiates any other class... new My Inner () 


class Myouter { 丁 _ 

private int x; wav ' a 


Mylnner inner = new Mylnner(); 
public void doStuff() { 

inner * go(); ^ .all a o, tKc 

rnir\CV" tlass 





MyOuter 


class Mylnner 
void go () { 


x = 42 



} 

} // close inner class 
} // close outer class 


TKc ^od m tlass uses 

ou*tcv tlass vanablc % , as • 七％ 

beloved io *tKc ivmcv dass. 



MyOuter 


r Side kqr 


You can instantiate an inner instance from code running outside the outer class, but you 
have to use a special syntax. Chances are you’ll go through your entire Java life and never 
need to make an inner class from outside, but just in case you're interested... 

class Foo { 

public static void main (String[] args) { 

MyOuter outerObj = new MyOuter(); 

MyOuter.Mylnner innerObj = outerObj.new Mylnner(); 



Mylnner 
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Now we can get the two-button 
code working 

public class TwoButtons 

JFrame frame; 

JLabel label; 

public static void main (String[] args) { 
TwoButtons gui = new TwoButtons (); 
gui.go(); 

} 

public void go() { 

frame = new JFrame(); 


{ 


乙 lass diocsv> 




Y\O^I 



frame.setDefaultCloseOperation(JFrame.EXIT ON CLOSE); 


JButton labelButton = new JButton (''Change Label"); 
labelButton.addActionListener(new LabelListener()) 



'七 d ,： lG s : 


JButton colorButton = new JButton (''Change Circle^) 


colorButton.addActionListener(new ColorListener()) 


label = new JLabel (''I'm a label"); 

MyDrawPane1 drawPanel = new MyDrawPanel(); 

frame.getContentPane().add(BorderLayout.SOUTH, colorButton) 
frame.getContentPane().add(BorderLayout.CENTER, drawPanel); 
frame.getContentPane().add(BorderLayout.EAST, labelButton); 
frame.getContentPane().add(BorderLayout.WEST, label); 


TwoButtons 

object 


frame.setSize(300,300) 
frame.setVisible(true) 



卜 试 i 二 


class LabelListener implements ActionListener { 
public void actionPerformed(ActionEvent event) 
label. setText (''Ouch! rr ); 


1^5 6laSS， 


} // close inner class 


卜 



class ColorListener implements ActionListener 


public void actionPerformed(ActionEvent event) { 
frame. repaint () ; 七 

II close inner class 祕 






object 


s 
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Java Bx^osedi 

This weeks interview: 
Instance of an Inner Class 


Head First: What makes inner classes important? 

Inner object： Where do I start? We give you a chance to 
implement the same interface more than once in a class. 
Remember, you can’t implement a method more than 
once in a normal Java class. But using inner classes, each 
inner class can implement the same interface, so you can 
have all these different implementations of the very same 
interface methods. 

Head First: Why would you ever want to implement the 
same method twice? 

Inner object： Let’s revisit GUI event handlers. Think 
about it... if you want three buttons to each have a 
different event behavior, then use three inner classes, all 
implementing ActionListener~which means each class 
gets to implement its own actionPerformed method. 

HeadFirst: So are event handlers the only reason to use 
inner classes? 

Inner object： Oh, gosh no. Event handlers are just an 
obvious example. Anytime you need a separate class, but 
still want that class to behave as if it were part of another 
class, an inner class is the best —— and sometimes only — way 
to do it. 

Head First: I’m still confused here. If you want the inner 
class to behave like it belongs to the outer class, why have 
a separate class in the first place? Why wouldn’t the inner 
class code just be in the outer class in the first place? 

Inner object： I just ^<2^ you one scenario, where you 
need more than one implementation of an interface. But 
even when you’re not using interfaces, you might need 
two different classes because those classes represent two 
different things. It’s good OO. 

Head First: Whoa. Hold on here. I thought a big part of 
OO design is about reuse and maintenance. You know, the 
idea that if you have two separate classes, they can each 
be modified and used independently, as opposed to stuffing 
it all into one class yada yada yada. But with an inner class, 
you’re still just working with one real class in the end, right? 
The enclosing class is the only one that’s reusable and 


separate from everybody else. Inner classes aren’t exactly 
reusable. In fact, I’ve heard them called “Reuseless —— 
useless over and over again.” 

Inner object： Yes it’s true that the inner class is not as 
reusable, in fact sometimes not reusable at all, because it’s 
intimately tied to the instance variables and methods of 
the outer class. But it —— 

Head First: — which only proves my point! If they’re not 
reusable, why bother with a separate class? I mean, other 
than the interface issue, which sounds like a workaround 
to me. 

Inner object： As I was saying, you need to think about 
IS-A and polymorphism. 

Head First: OK. And I’m thinking about them because... 

Inner object： Because the outer and inner classes 
might need to pass different IS-A tests! Let’s start with the 
polymorphic GUI listener example. What’s the declared 
argument type for the button’s listener registration 
method? In other words, if you go to the API and check, 
what kind of thing (class or interface type) do you have to 
pass to the addActionListenerO method? 

HeadFirst： You have to pass a listener. Something that 
implements a particular listener interface, in this case 
ActionListener. Yeah, we know all this. What’s your point? 

Inner object： My point is that polymorphically, you have 
a method that takes only one particular type. Something 
that passes the IS-A test for ActionListener. But —— and 
here’s the big thing~what if your class needs to be an IS- 
A of something that’s a class type rather than an interface? 

HeadFirst： Wouldn’t you have your class just extend the 
class you need to be a part of? Isn’t that the whole point 
of how subclassing works? If B is a subclass of A, then 
anywhere an A is expected a B can be used. The whole 
pass-a-Dog-where-an-Animal-is-the-declared-type thing. 

Inner object： Yes! Bingo! So now what happens if you 
need to pass the IS-A test for two different classes? Glasses 
that aren’t in the same inheritance hierarchy? 
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Head First： Oh, well you just... hmmm. I think I’m get¬ 
ting it. You can always implement more than one interface, 
but you can extend only one class. You can only be one kind 
of IS-A when it comes to class types. 

Inner object： Well done! Yes, you can’t be both a Dog 
and a Button. But if you’re a Dog that needs to some¬ 
times be a Button (in order to pass yourself to methods 
that take a Button), the Dog class (which extends Animal 
so it can’t extend Button) can have an inner class that acts 
on the Dog’s behalf as a Button, by extending Button, 
and thus wherever a Button is required the Dog can 
pass his inner Button instead of himself. In other words, 
instead of saying x.takeButton(this), the Dog object calls 
x.takeButton(new MylnnerButtonO). 

Head First： Can I get a clear example? 

Inner object： Remember the drawing panel we used, 
where we made our own subclass of JPanel? Right now, 
that class is a separate, non-inner, class. And that’s fine, 
because the class doesn’t need special access to the instance 
variables of the main GUI. But what if it did? What if 
we’re doing an animation on that panel, and it’s getting its 
coordinates from the main application (say, based on some¬ 
thing the user does elsewhere in the GUI). In that case, if 
we make the drawing panel an inner class, the drawing 
panel class gets to be a subclass of JPanel, while the outer 
class is still free to be a subclass of something else. 

Head First： Yes I see! And the drawing panel isn’t reus¬ 
able enough to be a separate class anyway, since what it’s 
actually painting is specific to this one GUI application. 

Inner object： Yes! You’ve got it! 

Head First： Good. Then we can move on to the nature of 
the relationship between you and the outer instance. 

Inner object： What is it with you people? Not enough 
sordid gossip in a serious topic like polymorphism? 

Head First： Hey, you have no idea how much the public is 
willing to pay for some good old tabloid dirt. So, someone 
creates you and becomes instantly bonded to the outer 
object, is that right? 

Inner object： Yes that’s right. And yes, some have 
compared it to an arranged marriage. We don’t have a say 
in which object we’re bonded to. 

Head First： Alright, I’ll go with the marriage analogy. 

Can you get a divorce and remarry something else? 

Inner object: No, it’s for life. 


Head First: Whose life? Yours? The outer object? Both? 

Inner object： Mine. I can’t be tied to any other outer 
object. My only way out is garbage collection. 

HeadFirst： What about the outer object? Can it be 
associated with any other inner objects? 

Inner object： So now we have it. This is what you really 
wanted. Yes, yes. My so-called ‘mate’ can have as many 
inner objects as it wants. 

HeadFirst： Is that like, serial monogamy? Or can it have 
them all at the same time? 

Inner object： All at the same time. There. Satisfied? 

HeadFirst： Well, it does make sense. And let’s not 
forget, it was j 似 extolling the virtues of “multiple 
implementations of the same interface”. So it makes sense 
that if the outer class has three buttons, it would need 
three different inner classes (and thus three different inner 
class objects) to handle the events. Thanks for everything. 
Here’s a tissue. 



you are here ► 381 



inner classes 


Using an mwcr class for animation 

We saw why inner classes are handy for event listeners, because 
you get to implement the same event-handling method more 
than once. But now we’ll look at how useful an inner class is when 
used as a subclass of something the outer class doesn’t extend. In 
other words, when the outer class and inner class are in different 
inheritance trees! 

Our goal is to make a simple animation, where the circle moves 
across the screen from the upper left down to the lower right. 


s*ta\rt 

-f'misK 

eoo 


000 

• 





參 


How simple animation works 

① Paint an object at a particular x and y coordinate 
g.fillOval (20,50,100,100); 

T2.O pixels -f\rom 

pixels -f\rom 七 he 


② Repaint the object at a different x and y coordinate 
g.fillOval (25,55,100,100); 

pixels -fv-om *thc 七弓弓 
pixels -f\rom *tof 

objcd*t moved a little 
Ao^jy\ *bo 


③ Repeat the previous step with changing x and y values 
for as long as the animation is supposed to continue. 


^tJierei£ireaiP 

Dumb Questions 

Why are we learning about 
animation here? I doubt if I'm 
going to be making games. 

You might not be making 
games, but you might be 
creating simulations, where 
things change over time to show 
the results of a process. Or you 
might be building a visualization 
tool that, for example, updates 
a graphic to show how much 
memory a program is using, 
or to show you how much 
traffic is coming through 
your load-balancing server. 
Anything that needs to take a 
set of continuously-changing 
numbers and translate them into 
something useful for getting 
information out of the numbers. 

Doesn’t that all sound business¬ 
like? That's just the "official 
justification’;of course.The real 
reason we’re covering it here is 
just because it’s a simple way 
to demonstrate another use 
of inner classes. (And because 
we just like animation, and our 
next Head First book is about 
J2EE and we /enow we can’t get 
animation in that one.) 
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What we really want is something like... 


class MyDrawPanel extends JPanel { 

public void paintComponent(Graphics g) { 
g.setColor(Color.orange); 
g.fill0val(x,y,100,100); 





e^^rpen your pencil 


But where do we get the new x and y 
coordinates? 


And who calls repaint()? 

See if you can design a simple solution to get the ball to animate from the top left of the 
drawing panel down to the bottom right. Our answer is on the next page, so don’t turn 
this page until you’re done! 

Big Huge Hint: make the drawing panel an inner class. 

Another Hint: don’t put any kind of repeat loop in the paintComponentO method. 

Write your ideas (or the code) here: 
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The complete simple animation code 

import javax.swing.*; 
import java.awt.*; 


public class SimpleAnimation { 


int x 
int y 





Tt. 'f 

t 6\v6lc- 


\)nt 


public static void main (String[] args) { 

SimpleAnimation gui = new SimpleAnimation (); 
gui.go(); 


public void go() { 

JFrame frame = new JFrame(); 

frame.setDefaultCloseOperation(JFrame.EXIT ON CLOSE); 


MyDrawPane1 drawPanel = new MyDrawPanel(); 

frame.getContentPane().add(drawPanel); 
frame.setSize(300,300); 
frame.setVisible(true); 


" 。卜 3 here, 4 -l 


•d^eis 


灼、 s ! 




for (int i = 0; i < 130; i++) 


this \lo i 


imcs 


X ++； 

y++; 


drawPanel. repaint () ; ^. 

try { 

Thread.sleep(50); 七 
} catch(Exception ex) { 


-the x ahd y 

^oo^aics y ( so 


set 


•^ovc so 


}// close go() method 


you 

w 7T^it ady khow ihis - ^ 


• Vs^ 


class MyDrawPanel extends JPanel { 

public void paintComponent(Graphics g) { 
g.setColor(Color.green); 

g.fillOval(x,y,40,40) ; Use ihc 6.0^, nil 

丄十〜 - 叩桃 d 


w w oJ c 7 Zsl ' hd y 


} // close inner class 
} // close outer class 
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Uh-oh. It didn’t move... it smeared. 


What did we do wrong? 


There's one little flaw in the paintComponent() 
method. 

We forgot to erase what was 
already there! So we got trails. 

To fix it, all we have to do is fill in the entire panel with 
the background color, before painting the circle each 
time. The code below adds two lines at the start of the 
method ： one to set the color to white (the background 
color of the drawing panel) and the other to fill the 
entire panel rectangle with that color. In English, the 
code below says, ''Fill a rectangle starting at x and y of 
0 (0 pixels from the left and 0 pixels from the top) and 
make it as wide and as high as the panel is currently. 



Hoi c ^iy ihc look 

3oi h g ^ 


public void paintComponent(Graphics g) { 
g.setColor(Color.white); 

g.fillRect (0,0, this .getWidth (> , this . getHeight ()); 


g.setColor(Color.green); 
g.fillOval (x,y, 40,40); 







Sharpen your pencil (optional, just for fun) 


What changes would you make to the x and y coordinates to produce the animations below? 
(assume the first one example moves in 3 pixel increments) 


• 


• 

start 

finish 

參 


• 

start 

finish 

參 


• 


X 

Y +5 


X 

Y 


X 

Y 


• 


• 

start 

finish 

• 


參 

start 

finish 

參 


• 


finish 


X 

Y 

X 

Y 

X 

Y 


start 


finish 


start 


you are here ► 385 
































Code Kitchen 




I 




Code Kitcken 












beat oy\c 


beat *U/o 


g o e ~ 



beat three 


©00 



beat -four 


• • • 



Let^s make a music video. Well use Java-generatect random 
grapkics tkat keep time witk tke music beats. 

Along tke way well register (anct listen for) a new kinct ol 
non-GUI event, triggerect hy tke music itself. 


Rcrwcmbcv, *tlVis pa\rt is all optional- Bu*t v/C *tiVmk \{!s ^ood -fo\r you. 


pa\rt i 一 

you’ll like it you tBr\ use i*t *to impv-css people- 

(Ok, sure, i 七 mi # 七 v/ov-k 。的 ly o 的 people v/ho avc v-cally c3sy *to ir^pv-css, 
bu 七 sfcll …） 
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Listening fora wow-&Ul cvcwt 


OK, maybe not a music video, but we will make 
a program that draws random graphics on the 
screen with the beat of the music. In a nutshell, 
the program listens for the beat of the music 
and draws a random graphic rectangle with each 
beat. 

That brings up some new issues for us. So far, 
we’ve listened for only GUI events, but now 
we need to listen for a particular kind of MIDI 
event. Turns out, listening for a non-GUI event is 
just like listening for GUI events: you implement 
a listener interface, register the listener with an 
event source, then sit back and wait for the event 
source to call your event-handler method (the 
method defined in the listener interface). 

The simplest way to listen for the beat of the 
music would be to register and listen for the 
actual MIDI events, so that whenever the 
sequencer gets the event, our code will get it 
too and can draw the graphic. But... there’s a 
problem. A bug, actually, that won’t let us listen 
for the MIDI events we re making (the ones for 
NOTE ON). 

So we have to do a little work-around. There 
is another type of MIDI event we can listen 
for, called a ControllerEvent. Our solution 
is to register for ControllerEvents, and then 
make sure that for every NOTE ON event, 
there’s a matching ControllerEvent fired at 
the same ‘beat’. How do we make sure the 
ControllerEvent is fired at the same time? We 
add it to the track just like the other events! In 
other words, our music sequence goes like this: 

BEAT 1 - NOTE ON, CONTROLLER EVENT 

BEAT 2 - NOTE OFF 

BEAT 3 - NOTE ON, CONTROLLER EVENT 
BEAT 4 - NOTE OFF 
and so on. 

Before we dive into the full program, though, 
let’s make it a little easier to make and add MIDI 
messages/events since in this program, we’re 
gonna make a lot of them. 


What the music art program 

needs to do: 

① Make a series of MIDI messages/ 
events to play random notes on a piano 
(or whatever instrument you choose) 

② Register a listener for the events 

③ Start the sequencer playing 

④ Each time the listeners event 
handler method is called, draw a 
random rectangle on the drawing 
panel, and call repaint. 


We’ll build it in three iterations: 

① Version One ： Code that simplifies mak¬ 
ing and adding MIDI events, since we 11 
be making a lot of them. 

② Version Two ： Register and listen for 
the events, but without graphics. 

Prints a message at the command-line 
with each beat. 

④ Version Three ： The real deal. Adds 
graphics to version two. 
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An easier way to make 
messages / events 


Right now, making and adding messages and 
events to a track is tedious. For each message, 
we have to make the message instance (in this 
case, ShortMessage), call setMessage(), make a 
MidiEvent for the message, and add the event 
to the track. In last chapter’s code, we went 
through each step for every message. That 
means eight lines of code just to make a note 
play and then stop playing! Four lines to add a 
NOTE ON event, and four lines to add a NOTE 
OFF event. 

ShortMessage a = new ShortMessage(); 
a.setMessage(144 , 1, note, 100); 

MidiEvent noteOn = new MidiEvent(a, 1); 
track.add(noteOn); 

ShortMessage b = new ShortMessage(); 
b•setMessage(128, 1, note, 100); 
MidiEvent noteOff = new MidiEvent(b, 16); 
track.add(noteOff); 


Things that have to happen for 
each event: 

① Make a message instance 

ShortMessage first = new ShortMessage (); 

② Call setMessage() with the instructions 

first. setMessage (192, 1, instrument, 0) 

③ Make a MidiEvent instance for the message 

MidiEvent noteOn = new MidiEvent (first, 1); 

④ Add the event to the track 

track.add(noteOn); 


Let’s build a static utility method that 
makes a message and returns a MidiEvent 




Aould Kappeh 



public static MidiEvent makeEvent(int comd, int chan, int one, int two, int tick) 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage(); 


^oo! A mctKod 


a• setMessage (comd, chan, one , two) ; ( ^kc 


event = new MidiEvent(a, tick); 


usi 


h 9 


}catch(Exception e) { 
return event; 


(a all 

loaded ^ ^cssa^c) 
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Example: how to use the wew static 
makeEventO method 

There’s no event handling or graphics here, just a sequence of 15 
notes that go up the scale. The point of this code is simply to learn 
how to use our new makeEvent() method. The code for the next 
two versions is much smaller and simpler thanks to this method. 


import javax.sound.midi.*; 
public class MiniMusicPlayerl 


d o^i I 


° ， Uh c f 


^po\r{ 


public static void main(String[] args) { 


try { 

Sequencer sequencer 
sequencer.open(); 


MidiSystem. getSequencer () ; ^^ 


( a W a SCT 




Sequence seq = new Sequence (Sequence . PPQ, 4) ; ^^ 3 

Track track = seq. createTrack () ; 3 ^ 3 *tvadk 


for (int i = 5; i < 61; i+= 4) { ^^-v^ake d of cvcr>*ts *to make Y\o{,ts keep 

^ r>o*tc ^ *to piar\o v\o*tc 


track.add(makeEvent(144,1,i,100,i)); 
track•add(makeEvent(128,1,i,100,i + 2)); 


s ^i ii v 


^11 


} // end loop 

sequencer.setSequence(seq); 
sequencer.setTempoInBPM(220); 
sequencer.start(); 

} catch (Exception ex) {ex.printstackTrace();} 
} // close main 


•^ess 

/Widi 




^hhihg 


public static MidiEvent makeEvent(int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage(); 
a•setMessage(comd, chan, one, two); 
event = new MidiEvent(a, tick); 

}catch(Exception e) { } 
return event; 

} 

} // close class 
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Version Two: registering and getting Cowtrollertvewts 

lA/c need -to 

y' so^c • 呵 uaUk i«sw 

import javax.sound.midi.*; ^ 

public class MiniMusicPlayer2 implements ControllerEventListener { 


public static void main(String[] args) { 

MiniMusicPlayer2 mini = new MiniMusicPlayer2(); 
mini.go(); 

} 

public void go() { 

try { 

Sequencer sequencer 
sequencer.open(); 


=MidiSystem.getSequencer(); 


:::總駿 


TV^c 




\Mt oA^i 


int[] eventsIWant = {127}; 

sequencer.addControllerEventListener(this, eventsIWant); 


Sequence seq = new Sequence(Sequence.PPQ, 4) 
Track track = seq.createTrack(); 


for (int i = 5; i < 60; i+= 4) { 

track.add(makeEvent(144,1,i,100,i)); 


track.add(makeEvent(176,1,127,0,i>); 



track•add(makeEvent(128,1,i,100,i + 2)); 
} // end loop 

sequencer.setSequence(seq); 
sequencer.setTempoInBPM(220); 
sequencer.start(); 

} catch (Exception ex) {ex.printstackTrace();} 
} // close 


Acme's how wc pi(ik up -the / 

雜賴 




public void controlChange(ShortMessage event) 
System, out .pr in tin (''la^); 


mss 班， 


public MidiEvent makeEvent(int comd, int chan, 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage(); 
a.setMessage(comd, chan, one, two); 
event = new MidiEvent(a, tick); 

}catch(Exception e) { } 
return event; 


int one, int two, int tick) { 


Code thafs different from the previous 
version is highlighted in gray, (and were 
not running it all within main() this time) 


} // close class 

390 chapter 12 










getting gui 


Version Three: drawing graphics w time with the music 

This final version builds on version two by adding the GUI parts. We build a 
frame, add a drawing panel to it, and each time we get an event, we draw a 
new rectangle and repaint the screen. The only other change from version 
two is that the notes play randomly as opposed to simply moving up the 
scale. 

The most important change to the code (besides building a simple GUI) 
is that we make the drawing panel implement the ControllerEventListener 
rather than the program itself. So when the drawing panel (an inner class) 
gets the event, it knows how to take care of itself by drawing the rectangle. 

Complete code for this version is on the next page. 


The drawing panel inner class: 




丁 V\c dbraV” 、 s a 成 


class MyDrawPane1 extends JPanel implements ControllerEventListener { 

boolean msg = false; d -flag -to -false, 3hd well set it 

to tvuc ohly whch wc get av\ cvch-fc. 


public void controlChange(ShortMessage event) { 
msg = true 
repaint() 




， 3 。七如 cvchi so WC sei ihc -flaa to 
t\ruc ahd ca\\ v-cpaihtO D 


public void paintComponent(Graphics g) { 
if (msg) { 


have to use ^ 


Graphics2D g2 = (Graphics2D) g; 




int r 
int gr 
int b 






(int) (Math.random() * 250); 

(int) (Math.random() * 250) 
(int) (Math.random() * 250); 


g.setColor(new Color(r,gr,b)) 


Tk \rcs-t is todt io gchcv-atc 
a v-ahdorn dolo\r 3hd paiht a 
scmi-.\rahdoinf» \rcdtahglc. 


int ht = (int) ((Math.random() * 120) + 10); 
int width = (int) ((Math.random() * 120) + 10) 
int x = (int) ((Math.random() * 40) + 10); 
int y = (int) ((Math.random() * 40) + 10); 
g.fillRect (x,y ,ht, width); 
msg = false; 

} // close if 
} // close method 
} // close inner class 
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MiniMusicPlayer3 code 



This is the complete code listing for Version 
Three. It builds directoy on Version Two. Try 
to annotate it yourself, without looking at the 
previous pages. 


import javax.sound.midi.*; 
import java.io.*; 
import javax.swing.*; 
import java.awt.*; 


public class MiniMusicPlayer3 { 


static JFrame f = new JFrame (''My First Music Video"); 
static MyDrawPanel ml; 

public static void main(String[] args) { 

MiniMusicPlayer3 mini = new MiniMusicPlayer3(); 
mini.go(); 

} // close method 

public void setUpGui() { 
ml = new MyDrawPanel(); 
f.setContentPane(ml); 
f•setBounds(30,30, 300,300); 
f.setVisible(true); 

} // close method 

public void go() { 
setUpGui(); 

try { 

Sequencer sequencer = MidiSystem.getSequencer(); 
sequencer.open(); 

sequencer.addControllerEventListener(ml, new int[] {127}); 

Sequence seq = new Sequence(Sequence.PPQ, 4); 

Track track = seq.createTrack(); 

int r = 0; 

for (int i = 0; i < 60; i+= 4) { 

r = (int) ((Math.random() * 50) + 1); 
track.add(makeEvent(144,1,r,100,i)); 
track.add(makeEvent(176,1,127,0,i)); 
track.add(makeEvent(128,1,r,100,i + 2)); 

} // end loop 

sequencer.setSequence(seq); 
sequencer.start(); 
sequencer.setTempoInBPM(120); 

} catch (Exception ex) {ex.printstackTrace();} 

} // close method 
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public MidiEvent makeEvent(int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage(); 
a.setMessage(comd, chan, one, two); 
event = new MidiEvent(a, tick); 

}catch(Exception e) { } 
return event; 

} // close method 


class MyDrawPane1 extends JPanel implements ControllerEventListener { 
boolean msg = false; 

public void controlChange(ShortMessage event) { 
msg = true; 
repaint(); 


public void paintComponent(Graphics g) { 
if (msg) { 

Graphics2D g2 = (Graphics2D) g; 

int r = (int) (Math.random() * 250); 
int gr = (int) (Math.random() * 250); 
int b = (int) (Math.random() * 250); 

g.setColor(new Color(r,gr,b)); 

int ht = (int) ((Math.random() * 120) + 10); 
int width = (int) ((Math.random() * 120) + 10); 

int x = (int) ((Math.random() * 40) + 10); 
int y = (int) ((Math.random() * 40) + 10); 

g.fillRect(x,y,ht, width); 
msg = false; 

} // close if 
} // close method 
} // close inner class 

} // close class 
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exercise: Who Am I 



A bunch of Java hot-shots, in full costume, are playing the party game"Who 
am W They give you a clue, and you try to guess who they are, based on 
what they say. Assume they always tell the truth about themselves. If they 
happen to say something that could be true for more than one guy, then 
write down all for whom that sentence applies. Fill in the blanks next to the 
sentence with the names of one or more attendees. 


Tonight’s attendees: 

Any of the charming personalities from this chapter just 
might show up! 


I got the whole GUI, in my hands. 

Every event type has one of these. 

The listener’s key method. 

This method gives JFrame its size. 

You add code to this method but never call it. 
When the user actually does something, it’s an — 
Most of these are event sources. 

I carry data back to the listener. 

An addXxxListener() method says an object is an 
How a listener signs up. 

The method where all the graphics code goes. 

I’m typically bound to an instance. 

The ‘g’ in (Graphics g), is really of class. 

The method that gets paintComponent() rolling. 
The package where most of the Swingers reside. 
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import javax.swing.*; 
import java.awt.event.*; 
import j ava.awt.*; 

class InnerButton { 

JFrame frame; 

JButton b; 


BE 如 compiler 



The Java file on lliis pa^e represents a 
complete source file. Your job is to play 
compiler and determine whetiier tiiis file 
will compile. If it won’t compile, how 
would you fix it, and if it does 
compile, what would it do? 


public static void main(String [] args) { 
InnerButton gui = new InnerButton(); 
gui.go(); 


public void go() { 
frame = new JFrame(); 
frame.setDefaultCloseOperation( 

JFrame.EXIT 一 ON 一 CLOSE); 

b = new JButton("A"); 
b.addActionListener(); 

frame.getContentPane()•add( 

BorderLayout.SOUTH, b); 
frame.setSize(200,100); 
frame.setVisible(true); 


class BListener extends ActionListener { 

public void actionPerformed(ActionEvent e) { 
if (b.getText().equals("A")) { 
b.setText("B 〃）； 

} else { 
b.setText("A"); 
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puzzle: Pool Puzzle 



1 puzz]e 


Your job is to take code snippets from 
the pool and place them into the blank 
lines in the code. You may use the 
same snippet more than once, 
and you won’t need to use all the 
snippets. Your goer/ is to make a 
class that will compile and run 
and produce the output listed. 


import javax.swing.*; 
import java.awt.*; 
public class Animate { 
int x = 1; 
int y = 1; 

public static void main (String[] args) { 
Animate gui = new Animate (); 
gui.go(); 

} 

public void go() { 

JFrame _ = new JFrame (); 

frame.setDefaultCloseOperation( 

JFrame.EXIT_ON_CLOSE); 


Output 

The Amazing, Shrinking, Blue Rectangle. 
This program will produce a blue 
rectangle that will shrink and shrink and 
disappear into a field of white. 


.getContentPane().add(drawP); 


_.setvisible(true); 

for (int i=0; i<124; _ 



try { 

Thread.sleep(50); 

} catch(Exception ex) { } 

} 

} 

class MyDrawP extends JPanel { 

public void paintComponent (Graphic 


Note: Each snippet 
from the pool can be 
used more than once! 




g.fillRect(x,y,x-500,y-250) 

g.fillRect(x,y / 500-x*2 / 250-y*2) ' ++ 

g.fillRect(500-x*2,250-y*2,x,y) ' ++, 乂 ++ 

x++ g.fillRect(0,0,250,500) l++, y++,X++ 

Y++ g.fillRect(0,0,500,250) Animate frame = new AnimateO 

广 ,, ■ , 、 ^ MyDrawP drawP = new MyDrawPO 

g.setColor(blue) 9 ■ ^ 

. , ■ 、、 drawP.paintO ContentPane drawP = new ContentPaneO 

g.setColor(white) draw 

g.setColor(Color.blue) frame raw.repaint drawP.setSize(500,270) 

l.setColor(Color.white) frame.setSize(500,270) 

panel.setSize(500,270y 
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Exercise Solutions 


Who am I? 


I got the whole GUI, in my hands. JFrame 

Every event type has one of these. listener interface 

The listener’s key method. actionP6rformed() 


BE 如 compiler 


import javax.swing.*; 
import java.awt.event.*; 
import j ava.awt.*; 

class InnerButton { 

JFrame frame; 

JButton b; 


Once this code 
is fixed, it will 
create a GUI with 
a button that 
toggles between 
A and B when you 
click it. 


This method gives JFrame its size. SetSize() 

You add code to this method but 

never call it. paintComponent() 


public static void main(String [] args) { 
InnerButton gui = new InnerButton(); 
gui.go(); 


When the user actually does 
something, it’s an 

event 

Most of these are event sources. 

swing components 

I carry data back to the listener. 

event object 

An addXxxListener( ) method 
says an object is an 

event source 

How a listener signs up. 

addActionListener() 

The method where all the 
graphics code goes. 

paintComponent() 

I’m typically bound to an instance. 

inner class 

The ‘g’ in (Graphics g), is 
really of this class. 

Graphics2d 

The method that gets 
paintComponent( ) rolling. 

repaint() 

The package where most of the 
Swingers reside. 

javax.swing 


public void go() { 
frame = new JFrame(); 
frame.setDefaultCloseOperation( 

JFrame.EXIT_ON_CLOSE); 


The addActionListener() 
method takes a class that 
implements the ActionLis- 
tener interface 


b = new JButton("A 〃）； 
b.addActionListener( hew PListewerl ))； 

frame.getContentPane()•add( 

BorderLayout.SOUTH, b); 
frame.setSize(200,100); 
frame.setVisible(true); 

} 

class BListener implements ActionListener { 
public void actionPerformed(ActionEvent e) { 
if (b.getText().equals("A")) { 
b.setText( <y B w ); 

} else { 
b.setText("A 〃）； 


ActionListener is an 
interface,interfaces 
are implemented, not 
extended 
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puzzle answers 



1 puzz]e 


The Amazing, Shrinking, Blue 
Rectangle. 




■ 

id 


import javax.swing.*; 
import java.awt.*; 
public class Animate { 
int x = 1; 
int y = 1; 

public static void main (String[] args) { 
Animate gui = new Animate (); 
gui.go(); 

} 

public void go() { 

JFrame f rarns = new JFrame (); 
frame•setDefaultCloseOperation( 

JFrame.EXIT_ON_CLOSE); 

MyDrawP drawP = new MyDrawP()； 

f Tarns. getContentPane () .add(drawP) ; 

frame.set5ize(500,270); 

f Tarns. setvisible(true) ; 

for (int i = 0; i < 124 ; i++ / X ++ ,y ++ ) { 

X++; 

drawP.repaint()； 

try { 

Thread.sleep(50); 

} catch(Exception ex) { } 

} 

} 

class MyDrawP extends JPanel { 

public void paintComponent(Graphics g ) { 

g.setColor(Color.white); 

g.fillRect(0,0,500,250); 

g.setColor(Color.blue); 

g.fillRect(x,y,500-x*2,250-y*2); 
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13 using swing 


Work on Your 
Swing 



Swing is easy. Unless you actually core where things end up on the screen. Swing code 
looks easy, but then you compile it, run it, look at it and think,"hey, that’s not supposed to go 
there.” The thing that makes it easy to code is the thing that makes it hard to control — the 
Layout Manager. Layout Manager objects control the size and location of the widgets in a 
Java GUI.They do a ton of work on your behalf, but you won’t always like the results. You want 
two buttons to be the same size, but they aren’t. You want the text field to be three inches long, 
but it’s nine. Or one. And under the label instead of nexf to it. But with a little work, you can get 
layout managers to submit to your will. In this chapter, we'll work on our Swing and in addition 
to layout managers, we’ll learn more about widgets. We’ll make them, display them (where we 
choose), and use them in a program. It’s not looking too good for Suzy. 
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components and containers 


Swing components 


Component is the more correct term for what we’ve been calling a widget. 
The things you put in a GUI. The things a user sees and interacts with. Text 
fields ， buttons, scrollable lists, radio buttons, etc. are all components. In 
fact, they all extend j avax. swing. JComponent. 

Components can be nested 

In Swing, virtually all components are capable of holding other 
components. In other words, you can stick just about anything into anything 
else. But most of the time, you’ll add user interactive components such as 
buttons and lists into background components such as frames and panels. 
Although it’s possible to put, say, a panel inside a button, that’s pretty 
weird, and won’t win you any usability awards. 


A widget is tecknically 
a Swing Component. 
Almost every tiling 
you can stick in a 

GUI extends JErom 
javax.swing[.J Component. 


With the exception of JFrame, though, the distinction between interactive 
components and background components is artificial. AJPanel, for 
example, is usually used as a background for grouping other components, 
but even aJPanel can be interactive. Just as with other components, you 
can register for the JPanel’s events including mouse clicks and keystrokes. 


Four steps to making a GUI (review) 

① Make a window (a JFrame) 

JFrame frame = new JFrame(); 

(2) Make a component (button, text field, etc.) 

JButton button = new JButton (''click me"); 

(3) Add the component to the frame 

frame.getContentPane().add(BorderLayout.EAST, button); 

(4) Display it (give it a size and make it visible) 

frame.setSize(300,300); 
frame.setVisible(true); 


Put interactive components: 


press here 


.choose me 


This \i a testt fie Id .X 






Into background components: 
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Layout Managers 

A layout manager is a Java object associated 
with a particular component, almost always a 
background component. The layout manager 
controls the components contained within the 
component the layout manager is associated 
with. In other words, if a frame holds a panel, 
and the panel holds a button, the panel’s layout 
manager controls the size and placement of 
the button, while the frame’s layout manager 
controls the size and placement of the 
panel. The button, on the other hand, 
doesn’t need a layout manager because the 
button isn’t holding other components. 

If a panel holds five things, even if those 
five things each have their own layout 
managers, the size and location of the five 
things in the panel are all controlled by the 
panel’s layout manager. If those five things, 
in turn, hold other things, then those other 
things are placed according to the layout 
manager of the thing holding them. 


As a layout manager, 

rm in charge of the size 
and placement of your components. 

In this GUI, I’m the one who decided 
how big these buttons should be, and 
where they are relative to each 
other and the frame. 



When we say hold we really mean add as in, a 
panel holds a button because the button was 
added to the panel using something like: 

myPanel.add(button); 

Layout managers come in several flavors, and 
each background component can have its own 
layout manager. Layout managers have their 
own policies to follow when building a layout. 
For example, one layout manager might insist 
that all components in a panel must be the same 
size, arranged in a grid, while another layout 
manager might let each component choose its 
own size, but stack them vertically. Here’s an 
example of nested layouts: 

JPanel panelA = new JPanel(); 
JPanel panelB = new JPanel(); 
panelB. add (new JButton (''button 
panelB. add (new JButton (''button 
panelB. add (new JButton (''button 
panelA.add(panelB); 




1 ")); 
2 ")); 
3")); 





Panel A 




you are here ► 401 
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How does the layout manager decide? 


Different layout managers have different policies for arranging 
components (like, arrange in a grid, make them all the same size, 
stack them vertically, etc.) but the components being layed out do 
get at least some small say in the matter. In general, the process of 
laying out a background component looks something like this: 


A layout scenario: 

① Make a panel and add three buttons to it. 

② The panels layout manager asks each button how big 
that button prefers to be. 


Lefs see here... the 
first button wants to be 
30 pixels wide, and the text field 
needs 50, and the frame is 200 pixels 
wide and I*m supposed to arrange 
everything vertically... 


© The panel’s layout manager uses its layout policies to decide 
whether it should respect all, part, or none of the buttons* 
preferences. 

④ Add the panel to a frame. 

⑤ The frames layout manager asks the panel how big the panel 
prefers to be. 

⑥ The frames layout manager uses its layout policies to decide 
whether it should respect all, part, or none of the panels 
preferences. 





different layout managers have different policies 


Some layout managers respect the size the component wants to 
be. If the button wants to be 30 pixels by 50 pixels, that’s what the 
layout manager allocates for that button. Other layout managers 
respect only part of the component’s preferred size. If the button 
wants to be 30 pixels by 50 pixels, it’ll be 30 pixels by however 
wide the button’s background panel is. Still other layout managers 
respect the preference of only the largest of the components 
being layed out, and the rest of the components in that panel 
are all made that same size. In some cases, the work of the layout 
manager can get very complex, but most of the time you can 
figure out what the layout manager will probably do, once you get 
to know that layout manager’s policies. 
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The Pig Three layout managers: 
border, flow, and box. 


using swing 


BorderLayout 

A BorderLayout manager divides a background 
component into five regions. You can add only one 
component per region to a background controlled 
by a BorderLayout manager. Components laid out 
by this manager usually don’t get to have their 
preferred size. BorderLayout is the default layout 
manager for a frame! 





FlowLayout 

A FlowLayout manager acts kind of like a word 
processor, except with components instead of 
words. Each component is the size it wants to be, 
and they're laid out left to right in the order that 
they're added, with ''word-wrap" turned on. So 
when a component won’t fit horizontally, it drops 
to the next 、、 line” in the layout. FlowLayout is the 
default layout manager for a panel! 



O 卜 I — 


added l c -fi 

: test 


BoxLayout 

A BoxLayout manager is like FlowLayout in that 
each component gets to have its own size, and 
the components are placed in the order in which 
they're added. But, unlike FlowLayout, a BoxLayout 
manager can stack the components vertically (or 
horizontally, but usually were just concerned with 
vertically). IVs like a FlowLayout but instead of 
having automatic component wrapping*, you can 
insert a sort of component return key* and force 
the components to start a new line. 
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border layout 



BorderLayout cares 
about five regions: 

east, west, north, 

south, and center 


Let’s add a button to the east regions 


import javax • swing • * ; 丄 ; av a a>wt 汰 ay 

import java.awt.*; ^ ^ ^ ^ 

public class Buttonl { 

public static void main (String[] args) { 

Buttonl gui = new Buttonl(); 
gui.go(); 

} 

public void go() { 

JFrame frame = new JFrame(); 

JButton button = new JButton (''click me"); 
frame.getContentPane().add(BorderLayout.EAST, button); 
frame.setSize(200,200); 
frame.setVisible(true); 







0 


Brain Barbell 


How did the BorderLayout manager come up with 
this size for the button? 


What are the factors the layout manager has to 
consider? 


Why isn't it wider or taller? 


9 0 0 




cttck me 


^ - .A 
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Watch what happens when we give 
the button more characters... 


public void go() { 

JFrame frame = new JFrame(); 




\tlt 

OV' 








JButton button = new JButton (''click like you mean it 〃）； 

frame.getContentPane()•add(BorderLayout•EAST, button); 
frame.setSize(200,200); 


frame.setVisible(true); 




Since \Ys in the east 
region of a border layout, 
ril respect its preferred width. But 
I don’t care how tall it wants to be; 
it’s gonna be as tall as the frame, 
because thafs my policy. 

o 0 ' 





Next time 
I'm go in' with flow 
layout. Then I get 
EVERYTHING I 
want. 
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border layout 


Let’s try a button in the NORTH region 


public void go() { 


JFrame frame = new JFrame(); 

JButton button = new JButton (''There is no spoon. . •’’）； 

frame.getContentPane().add(BorderLayout. NORTH ^ button); 
frame.setSize(200,200); 
frame.setVisible(true); 


e o o 




There is no spoon." 


A 


L3W as 

Wtt 的 ' s u a i as as 


Now let’s make the button ask to be taller 


How do we do that? The button is already as wide 
as it can ever be—as wide as the frame. But we 
can try to make it taller by giving it a bigger font. 


public void go() { 

JFrame frame = new JFrame(); 

JButton button = new JButton (''Click This !〃）； 

Font bigFont = new Font (''serif 〃， Font.BOLD, 28); 
button.setFont(bigFont); 

frame.getContentPane().add(BorderLayout. NORTH A button); 
frame.setSize(200,200); 




frame.setVisible(true); 


e 0 o 


Click This! 


A 


t s 〆,Wt _ 

\\cr- 


TV 

— 一 一 
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I think I'm getting it... if I'm in east or 
west, I get my preferred width but the 
height is up to the layout manager. And 
if rm in north or south, \ fs just the 
opposite—I get my preferred height, but 
not width. 



But wkat kappens 
in tke center region? 


The center region gets whatever’s left! 

(except in one special case we’ll look at later) 

public void go() { 

JFrame frame = new JFrame(); 

JButton east = new JButton (''East ”）； 
JButton west = new JButton (''West ”）； 
JButton north = new JButton (''North ”）； 
JButton south = new JButton (''South ”）； 
JButton center = new JButton (''Center^); 


frame.getContentPane().add(BorderLayout•EAST, east); 
frame.getContentPane().add(BorderLayout•WEST, west); 
frame.getContentPane().add(BorderLayout.NORTH, north); 
frame.getContentPane()•add(BorderLayout•SOUTH, south); 
frame.getContentPane().add(BorderLayout• CENTER, center); 


frame.setSize( 300 , 300 ); 

frame.setVisible(true); 


: d r s 


辦口么广 


e o o 





North 



f > r 


> f 



West 


Center 


East 


South 






ZOO pixels 


4 


xn o\r ：_ 


you 

ih "the hov-i 


^ h ，i L bc ^ ^11 -they 
th ^ C 9 ,0hs e ^y 


you are here ► 407 






























flow layout 


ao 

0^ / ~ vl 

SD 


FlowLayout cares 
about the flow of the 
components: 

left to right，top to bottom, in 
the order they were added. 


Let’s add a panel to the east region: 


A JPaneFs layout manager is FlowLayout, by default. When we add 
a panel to a frame, the size and placement of the panel is still 
under the BorderLayout managers control. But anything inside the 
panel (in other words, components added to the panel by calling 
panel. add (aComponent) ) are under the panel's FlowLayout 
managers control. Well start by putting an empty panel in the frames 
east region, and on the next pages we 11 add things to the panel. 




import javax.swing.*; 
import java.awt.*; 

public class Pane11 { 

public static void main (String[] args) 
Panel1 gui = new Panell(); 
gui.go(); 



Wke the pahd gv-ay so wc stt 

it is Oh -the 


public void go() { 

JFrame frame = new JFrame(); 

JPanel panel = new JPanel(); 
panel.se tBackground(Color.darkGray); 
frame.getContentPane().add(BorderLayout.EAST, panel); 
frame.setSize(200,200); 
frame.setVisible(true); 
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Let’s add a button to the panel 


public void go() { 

JFrame frame = new JFrame(); 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton (''shock me 〃） 


panel.add(button); 
frame.getContentPane().add(BorderLayout•EAST, panel) 




frame.setSize(250,200); 
frame.setVisible(true); 




The expanded/ 

‘d the bui-toh aoi iis 


pWd si^Vbo-th 

〜而 p 如 I 



The frames 
BorderLayout manager 


The panel's 
FlowLayout manager 
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flow layout 


What happens if we add TWO buttons 
to the panel? 


public void go() { 


JFrame frame = new JFrame(); 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton (''shock me ”）； 
JButton buttonTwo = new JButton ( 、 'bliss 〃）； 




panel.add(button); 
panel.add(buttonTwo) 



3dd 断 〜 ih 




frame.getContentPane()•add(BorderLayout•EAST, panel); 
frame.setSize(250,200); 
frame.setVisible(true); 


what we wanteck 


what we got: 


e o o 






If the code above were modified to the code below, 
what would the GUI look like? 


JButton button = new JButton (''shock me ’’）； 
JButton buttonTwo = new JButton (''bliss ”）； 
JButton buttonThree 二 new JButton ( 、 'huh ?〃）； 
panel.add(button); 
panel.add(buttonTwo); 
panel.add(buttonThree); 


e o o 



^ p 办 d 






㈣ 。一). 



Draw what you 
think the GUI would 
look like if you ran 
the code to the left. 

(Then try it!) 
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BoxLayout to the rescue! 

It keeps components 
I stacked, even if there’s room 
1 to put them side by side. 


Unlike FlowLayout，BoxLayout can force a 
fi new line 9 to make the components wrap to 
the next line, even if there’s room for them 
to fit horizontally. 

But now you’ll have to change the panel’s layout manager from the 
default FlowLayout to BoxLayout. 


public void go() { 

JFrame frame = new JFrame(); 
JPanel panel = new JPanel(); 
panel.setBackground(Color.darkG 


to V)C a ^ 


panel.setLayout(new BoxLayout(panel, BoxLayout.Y_AXIS)); 

JButton button = new JButton (''shock me"); 'the io kno 

JButton buttonTwo = new JButton (''bliss” ）； its byih0 ou-fc (j c *thc Pa ^1) 

frame.getContentPane().add(BorderLayout.EAST, panel); 
frame.setSize(250,200); 
frame.setVisible(true); 


eoo 



輝 s 織 S 
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fJierei£irejio 

Dumb Questions 

How come you can’t add directly to a frame the way 
you can to a panel? 

A JFrame is special because it’s where the rubber 
meets the road in making something appear on the screen. 
While all your Swing components are pure Java, a JFrame 
has to connect to the underlying OS in order to access the 
display.Think of the content pane as a 1 00% pure Java layer 
that sits on top of the JFrame. Or think of it as though JFrame 
is the window frame and the content pane is the... glass. You 
know, the window pane. And you can even swap the content 
pane with your own JPanel, to make your JPanel the frame’s 
content pane, using, 

myFrame. setContentPane (myPanel); 

Can I change the layout manager of the frame? 
What if I want the frame to use flow instead of border? 

^\^lThe easiest way to do this is to make a panel, build 
the GUI the way you want in the panel, and then make that 
panel the frame’s content pane using the code in the previ¬ 
ous answer (rather than using the default content pane). 

What if I want a different preferred size? Is there a 
setSizeO method for components? 

Yes, there is a setSizeO, but the layout managers will 
ignore it.There’s a distinction between the preferred size of 
the component and the size you want it to be.The preferred 
size is based on the size the component actually needs 
(the component makes that decision for itself).The layout 
manager calls the component’s getPreferredSizeO method, 
and that method doesn’t care if you’ve previously called 
setSizeO on the component. 

Can’t I just put things where I want them? Can I turn 
the layout managers off? 

^\^lYep. On a component by component basis, you can call 
setLayout (null) and then it’s up to you to hard-code 
the exact screen locations and dimensions. In the long run, 
though, it’s almost always easier to use layout managers. 


- BULLET POINTS - 

■ Layout managers control the size and location of 
components nested within other components. 

■ When you add a component to another component 
(sometimes referred to as a background component, 
but that’s not a technical distinction), the added 
component is controlled by the layout manager of the 
background component. 

■ A layout manager asks components for their 
preferred size, before making a decision about 
the layout. Depending on the layout manager’s 
policies, it might respect all, some, or none of the 
component’s wishes. 

■ The BorderLayout manager lets you add a 
component to one of five regions. You must specify 
the region when you add the component, using the 
following syntax: 

add(BorderLayout.EAST, panel); 

■ With BorderLayout, components in the north and 
south get their preferred height, but not width. 
Components in the east and west get their preferred 
width, but not height. The component in the center 
gets whatever is left over (unless you use pack ()). 

■ The pack() method is like shrink-wrap for the 
components; it uses the full preferred size of the 
center component, then determines the size of the 
frame using the center as a starting point, building 
the rest based on what’s in the other regions. 

■ FlowLayout places components left to right, top to 
bottom, in the order they were added, wrapping to a 
new line of components only when the components 
won’t fit horizontally. 

■ FlowLayout gives components their preferred size in 
both dimensions. 

■ BoxLayout lets you align components stacked 
vertically, even if they could fit side-by-side. Like 
FlowLayout, BoxLayout uses the preferred size of 
the component in both dimensions. 

■ BorderLayout is the default layout manager for a 
frame; FlowLayout is the default for a panel. 

■ If you want a panel to use something other than flow, 
you have to call setLayout () on the panel. 
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using swing 


Playing with Swing components 

You’ve learned the basics of layout managers, so now let’s try out a 
few of the most common components: a text field，scrolling text area, 
checkbox, and list. We won’t show you the whole darn API for each of 
these, just a few highlights to get you started. 



JTextField 



How to use it 

© Set text out of it 

System, out.println (field. getText ()); 


© Put text in it 


field. setText (''whatever"); 
field. setText(''^ ^ ^ 


③ 


Set an ActionEvent when the user 
presses return or enter 




field. addActionListener (myActionListener); 


④ Select/Highlight the text in the field 

field. selectAll (); 


⑤ Put the cursor back in the field (so the user 
can just start typing) 


field. requestFocus (); 


you are here ► 
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text area 


J Text Area 



Unlike JTextField, JTextArea can have more than one line of text. It 
takes a little configuration to make one, because it doesiVt come out of 
the box with scroll bars or line wrapping. To make a JTextArea scroll, you 
have to stick it in a Scroll Pane. A ScrollPane is an object that really loves 
to scroll, and will take care of the text areas scrolling needs. 


Constructor 

JTextArea text 


10 V avxS 
new JTextArea(10,20); 


一 (二::二工一 


How to use 


① Make it have a vertical scrollbar only 








JScrollPane scroller = new JScrollPane(text); 
text. setLineWrap( true); ‘ _ 丁赠 ^ W ⑽？?叫 




scroller.setVerticalScrollBarPolicy(ScrollPaneCons tants.VERTICAL—SCROLLBAR 一 ALWAYS); 
scroller.setHorizontalScrollBarPolicy(ScrollPaneConstants.HORIZONTAL—SCROLLBAR 一 NEVER) 

panel.add(scroll^r)?^ ^poir^//, 

广 j P 如 ih e s ^ 0 n ( 

d 。“刪 he A h n d ihc ^oH ^ 

ca dl ^y io ihc p^ c |/ io ^ Yo 


® Replace the text that's in it 


t 

ou 


text. setText (''Not all who are lost are wandering"); 


③ Append to the text that’s init 

text.append(''button clicked"); 

④ Select/Highlight the text in the field 

text.selectAll(); 


⑤ Put the cursor back in the field (so the user 
can just start typing) 

text.requestFocus(); 
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using swing 


JTextArea example 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 

public class TextAreal implements ActionListener { 
JTextArea text; 

public static void main (String[] args) { 
TextAreal gui = new TextAreal(); 
gui.go(); 


public void go() { 

JFrame frame = new JFrame(); 

JPanel panel = new JPanel(); 

JButton button = new JButton (''Just Click It 〃）； 
button.addActionListener(this); 
text = new JTextArea(10,20); 
text.setLineWrap(true); 



JScrollPane scroller = new JScrollPane(text); 

scroller.setVerticalScrollBarPolicy(ScrollPaneConstants•VERTICAL—SCROLLBAR 一 ALWAYS); 
scroller.setHorizontalScrollBarPolicy(ScrollPaneConstants.HORIZONTAL SCROLLBAR NEVER); 


panel.add(scroller); 

frame.getContentPane().add(BorderLayout.CENTER, panel) 
frame.getContentPane().add(BorderLayout.SOUTH , button) 

frame.setSize(350,300); 
frame.setVisible(true); 


public void actionPerformed(ActionEvent ev) { 
text. append (''button clicked \n "); 


/hSClrt a hew lihc so j 


Oh ^ 


000 


llck#dbutton cllClL#dbuiton <lici ^ 
clickcdbutton cllckcdbutton cUD 
or> cUck«dbutton cl! 


button cl ickMtxj 
«dbutton 

ck^dbuttco click«^buttor> click«dbutton cB 
Uckrdbultoo rliclir>dbulton cl lckrdbultonU 
clickedbutton clickedbutton cllckedbuttU 
on click«dbutton c\tck«dbuttoo click^dbJ) 
l ickr-dbulton cUckrdbutton clicked! 

clickedbiftton click^ 

jtton clickeObutton cli 
cllckrdbutton cUckrdbutton r 


(U 


^button clickcdbutto 
^K^buttan cltckKtMit 
rkrdbutton clickrdb 


lint Cltck I 


\ 
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check box 


JCheckBox 



Constructor 

JCheckBox check = new JCheckBox (''Goes to 11"); 

How to use it 

① Listen for an item event (when it's selected or deselected) 

check.addltemListener(this); 


② Handle the event (and find out whether or not it’s selected) 

public void itemStateChanged(ItemEvent ev) { 

String onOrOff = 、、 off 〃； 

if (check. isSelected ()) onOrOff = 、、 on 〃； 

System, out .pr in tin (''Check box is '' + onOrOff); 


③ Select or deselect it in code 

check.setSelected(true); 
check.setSelected(false); 



Aren’t the layout manag¬ 
ers just more trouble than they’re 
worth? If I have to go to all this 
trouble, I might as well just hard- 
code the size and coordinates for 
where everything should go. 

Getting the exact layout 
you want from a layout man¬ 
ager can be a challenge. But think 
about what the layout manager 
is really doing for you. Even the 
seemingly simple task of figuring 
out where things should go on 
the screen can be complex. For 
example, the layout manager takes 
care of keeping your components 
from overlapping one another. 

In other words, it knows how to 
manage the spacing between 
components (and between the 
edge of the frame). Sure you can 
do that yourself, but what happens 
if you want components to be 
very tightly packed? You might get 
them placed just right, by hand, 
but that’s only good for your JVM! 

Why? Because the components 
can be slightly different from 
platform to platform, especially if 
they use the underlying platform’s 
native look and feel’. Subtle things 
like the bevel of the buttons can 
be different in such a way that 
components that line up neatly 
on one platform suddenly squish 
together on another. 

And we’re still not at the really Big 
Thing that layout managers do. 
Think about what happens when 
the user resizes the window! Or 
your GUI is dynamic, where com¬ 
ponents come and go. If you had 
to keep track of re-laying out all 
the components every time there’s 
a change in the size or contents of 
a background component...yikes! 
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using swing 


JList 


e o o 


alpha 

beta 

gamma 

delta 




A 


Constructor 


i Usi lakes ^ r , 


String [] listEntries = {''alpha", ''beta", ''gamma", ''delta", 

''epsilon", 、 'zeta", 、 'eta", ''theta、'}; 

list = new JList(listEntries); 


How to use it 

① Make it have a vertical scrollbar 




JScrollPane scroller = new JScrollPane(list); 
scroller.setVerticalScrollBarPolicy(ScrollPaneCons tants.VERTICAL_SCROLLBAR_ALWAYS); 
scroller.setHorizontalScrollBarPolicy(ScrollPaneConstants•HORIZONTAL—SCROLLBAR 一 NEVER) 

panel.add(scroller); 


② Set the number of lines to show before scrolling 

list.setVisibleRowCount(4); 

③ Restrict the user to selecting only ONE thing at a time 

list.setSelectionMode(ListSelectionModel.SINGLE SELECTION) 


@ Register for list selection events 

list.addListSelectionListener(this); 


⑤ Handle events (find out which thing in the list was selected) 


七 T\A/|Ct ^ 7 ou 如 〆 乇 



You 11 even 

? VA*t m *tw»s test- 


public void valueChanged(ListSelectionEvent lse) { 
if( !lse.ge tValueIsAdj us ting()) { 

String selection = (String) list.getSelectedValueO ; jc-feScIcd-tcdl/alucO 此七 II 

一一一 • 卜？外 〆 . Alisi iLi 

limited to ohl 


System.out.println(selection); 


々 S-tirihg objects. 
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Code Kitchen 






% 


Code Kitcken 


氷 






cT 


c ； 




J3 


eoo 


j- 




Cyber BeatBox 




Bass Drum 


n n n n n n ^ n n n n n n n rn r 


Start 




Closed Hi-Hat □ □ g □□□□□□□□□□ g 口 □/ Stop \ 
Open Hi-Hat O O J™[ F - ! n J - ! Q O Q O O O f - ! ^ 1 ~! > --——-^ 

J » _ I L^_J 1 i L^_J . i L^_J ■ — I J I I I ■ i L^_J I I I I 1.^8 翁 b r g 

Tempo Up 

Acoustic Snare 


Crash Cymbal □ □ 0 g □□□□ @ □□□ □□ □ □ C Tem P° Down 
Hand Clap 

卜 - u 1--J L_» L_ u 1 1 L_ / L_> L_^ L—« 

High Tom ^ 厂 1 □□ 厂 1 □ 厂 1 厂 丨 H 门门厂 i 门 □ 门厂 i 

■^F 


Hi Bongo 
Maracas 
Whistle 
Low Conga 
CowbetE 
Vi bras lap 


□ □□□ □□□□□. 口 □□□□□□ 

nnnnnnnplnnnnnnnn 

« * I_» ■ * I_I * « i_I « * I I ■ ■ I_I * » I_I » * I_I » ■ I_I 

n n n n n n n n n n n n n n n n 

1 _» '_■ »_ - ■_■ *__ ■_ - _- ^_ __ - - _ ■_ “ -_- __ ■ __» 

n n n n n n n n n n n n n n n n 

L^_J I _ ^ L^kJ I il L^_J l L _ . i • 1 I I L^—J I _ I L^^el L^hJ 

□ □ @ □ Q □ □ O D ^ '二 

n n n n n n n n n n M n n n n n 

I^bJ I I L^-J I_I • 1 I I L^_J I _ I L^_l I I I __l 1 1 ■ ■ I _ 1 L^-J I _ i 

Low-mid Tom □□□□□□ □□□□□□□□ 唐 □ 
High Aaoqo ― _ : ~ ~ — _: _! ~ _: — : ; — : —: ~ 

>H r '^r 

Open Hi CongaH □□□□.□□□ □□□□□□□□ 




Tkis part’s optional. We’re making tke full BeatBox, GUI 
and all. In tke Saving Objects ckapter, we’ll learn kow to 
save anct restore ctrum patterns. Finally, in tke networking 
ckapter (Make a Connection), we’ll turn tke BeatBox into a 
working ckat client. 
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using swing 


Makmg the PcatPox 

This is the full code listing for this version of the BeatBox, with buttons for starting, 
stopping, and changing the tempo. The code listing is complete, and fully- 
annotated, but here’s the overview: 


① Build a GUI that has 256 checkboxes (JCheckBox) that start out 
unchecked, 16 labels (JLabel) for the instrument names, and four 
buttons. 

② Register an ActionListener for each of the four buttons. We don't 
need listeners for the individual checkboxes, because we aren't 
trying to change the pattern sound dynamically (i.e. as soon as the 
user checks a box). Instead, we wait until the user hits the 'start* 
button, and then walk through all 256 checkboxes to get their state 
and make a MIDI track. 


Set-up the MIDI system (youve done this before) including getting 
a Sequencer, making a Sequence, and creating a track. We are using 
a sequencer method that's new to Java 5.0, setLoopCount(). This 
method allows you to specify how many times you want a sequence 
to loop. Were also using the sequence's tempo factor to adjust the 
tempo up or down, and maintain the new tempo from one iteration of 
the loop to the next. 


When the user hits 'start 1 , the real action begins. The event-handling 
method for the 'start 1 button calls the buildTrackAndStart() method. 
In that method, we walk through all 256 checkboxes (one row at 
a time, a single instrument across all 16 beats) to get their state, 
then use the information to build a MIDI track (using the handy 
makeEvent() method we used in the previous chapter). Once the track 
is built, we start the sequencer, which keeps playing (because were 
looping it) until the user hits 'stop’. 


you are 


here ► 
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BeatBox code 


import 

import 

import 

import 

import 


java.awt.*; 
javax.swing.*; 
javax.sound.midi.*; 
java.util.*; 
java.awt.event.*; 


public class BeatBox { 


JPanel mainPanel; ^~m A^ a V L，s ^ 

ArrayList<JCheckBox> checkboxList; 

Sequencer sequencer; 


Sequence sequence; 
Track track; 

JFrame theFrame; 



These hames of the '^sbr^^is, as a 

awy, k buildrng the ^U| labels U each 


String[] instrumentNames = {''Bass Drum", ''Closed Hi-Hat", 

''Open Hi-Hat 〃，” Acoustic Snare”，''Crash Cymbal”，''Hand Clap ”， 

''High Tom’’，''Hi Bongo’’ ， ''Maracas’’ ， ''Whistle’’，''Low Conga ’’， 
''Cowbell", ''Vibraslap", ''Low-mid Tom", ''High Agogo", 

''Open Hi Conga’’}; 

int[] instruments = {35,42,46,38,49,39,50,60,70,72,64,56,58,47,67,63}; 


public static void main (String[] args) { 
new BeatBox2().buildGUI(); 

} 

public void buildGUI() { 



the adtual dv^um (keys，. 

,m I is like a piaho, 

Wis a di-P-Pcv-ch-t d \rum. 

5 ° Vr bc r, is ^ -the Bass 

dv»um, 午 2 is Closed Hi-Hat, tit. 


the Frame = new JFrame (''Cyber BeatBox"); 

theFrame.setDefaultCloseOperation(JFrame.EXIT—ON—CLOSE); 
BorderLayout layout = new BorderLayout(); 

JPanel background = new JPanel(layout); 

background.setBorder(BorderFactory.createEmptyBorder(10,10,10,10)); 


checkboxList = new ArrayList<JCheckBox>(); 

Box buttonBox = new Box(BoxLayout.Y— AXIS); 

JButton start = new JButton (' 、 Start"); 

start.addActionListener(new MyStartListener()); 





buttonBox.add(start); 


JButton stop = new JButton (''Stop ,r ); 

stop.addActionListener(new MyStopListener()); 

buttonBox.add(stop); 

JButton upTempo = new JButton (''Tempo Up"); 
upTempo.addActionListener(new MyUpTempoListener()); 
buttonBox.add(upTempo); 


Ko-bWm^ sPC6«al 
dodc- You vc scc^ mo 


\us*b lots Jc 6 (\A\ 
st \i behove. 


JButton downTempo = new JButton (''Tempo Down"); 
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using swing 


downTempo.addActionListener(new MyDownTempoListener()); 
buttonBox.add(downTempo); 


Box nameBox = new Box(BoxLayout.Y— AXIS); 
for (int i = 0; i < 16; i++) { 

nameBox.add(new Label(instrumentNames[i])); 


background.add(BorderLayout.EAST, buttonBox); 
background.add(BorderLayout.WEST, nameBox); 


St，li more ^Ul 6odc. 

|\(o*bW»v\^ \rCw\3'rk3D»C- 


theFrame.getContentPane().add(background); 

GridLayout grid = new GridLayout(16,16); 

grid.setVgap(1); 

grid.setHgap(2); 

mainPanel = new JPanel(grid); 

background.add(BorderLayout.CENTER, mainPanel); 


for (int i = 0; i < 256; i++) { 
JCheckBox c = new JCheckBox() 
c.setSelected(false); 
checkboxList.add(c); 
mainPanel.add(c); 

} // end loop 

setUpMidi(); 


笠?蛛 


theFrame.setBounds(50,50,300,300); 

theFrame.pack(); 

the Frame . setVisible (true); 

} // close method 


public void setUpMidi() { 
try { 

sequencer = MidiSystem.getSequencer(); 
sequencer.open(); 

sequence = new Sequence(Sequence.PPQ,4); 
track = sequence.createTrack(); 
sequencer.setTempoInBPM(120); 



} catch(Exception e) {e.printStackTrace();} 


} // close method 


織 ㈣ 

t TmIc Agam, ho-thihg sp^ial. 
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BeatBox code 


TWlS * lS ail V>a^^s! VV^c v/c 

七咖 —staU 。 吖仞 

办 d add 七七 o 如 Tvadk. 

public void buildTrackAndStart() { 
int[] trackList = null; < 








a zjcvo- 


sequence.deleteTrack(track) 
track = sequence.createTrack 


： (); WoUU—^ 祕 


for (int i = 0; i < 16; i++) 
trackList = new int[16]; 


do tWis 


int key = instruments[i] 




for (int j = 0; j < 16; j++ ) { ^ 


p 0 恤 W W oU^ 邡 ATS U 恤 … 




JCheckBox jc = (JCheckBox) checkboxList.get(j + (16*i)); 
if ( jc.isSelected()) { 
trackList[j] = key; 

} else { 

trackList[j] = 0; 


} // close inner loop 



|s the dhcdkbo^ ai -this bca*t st\ctitd? l-f yes, fu*t 
*tKc key value m -this slo*t m -tKc avv-ay (七 he slot *tha 七 
v-cfv-cscr>*b "this bca*t). Oihcv-v/isc, 七 he ms*br_ ⑶七 is 
MOT supposed io flay a*t 七 his bca*t, so sci i*t *to z^v-o. 


makeTracks (trackList) ; ^ ' por *tWis ms—uwe 此 and a|l 1 

track.add(makeEvent(176,1,127,0,16)) ; CVC^*U and ddd 七 o Vc^ 

} // close outer 


track.add(makeEvent(192,9,1,0,15)); 
try { 


\th aUavs v/arrt to make suv-c that S a ^ vc ^ a ^, 

bca 七 lOi 七 O to K). 0 -tKcvVisc, tJcatkJo% m.^ht 
⑽七沪栎 dll A beats behove \i staves ovcv. 


sequencer. setSequence (sequence); 
sequencer.setLoopCount(sequencer.LOOP_CONTINUOUSLY); 
sequencer.start(); 
sequencer.setTempoInBPM(120); 

} catch(Exception e) {e.printStackTrace();} 

} // close buildTrackAndStart method 

Mw play tub rm^/i 



Lets you spc 6 -fy r\umbcv- 
loop i-tcv-atio^s, or m *tKis 
dorrtmuous loof m^- 


public class MyStartListener implements ActionListener 
public void actionPerformed(ActionEvent a) { 
buildTrackAndStart(); 

} 

} // close inner class 


Fijrst of the ihhClr classes, 
.stch^s ^ ihc button. 
/Vothih3 special hcvc. 
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using swing 


public class MyStopListener implements ActionListener { 
public void actionPerformed(ActionEvent a) { 
sequencer.stop(); 

} 

} // close inner class 

public class MyUpTempoListener implements ActionListener { 
public void actionPerformed(ActionEvent a) { 

float tempoFactor = sequencer.getTempoFactor(); 
sequencer. setTempoFactor ((float) (tempoFactor * 1.03)) 

} 

} // close inner class 

public class MyDownTempoListener implements ActionListener 
public void actionPerformed(ActionEvent a) { 
float tempoFactor = sequencer.getTempoFactor(); 
sequencer. setTempoFactor ((float) (tempoFactor * . 97)); 

} 

} // close inner class 


othev* ihhcv dlass 
listchcvs (oy the buttohs 



The TFad*tov- scales 
the tempo by 

-Pa^-tov- pv-ovided- The 
dc-rau|*t is 1 . 0 , so y/cVc 
ad\ustmft +/ - 5% pev- 
dlidk. 



public void makeTracks(int[] list) { 


for (int i = 0; i < 16; i++) { 

int key = list[i]; 


^ beats. So Lld ^e, 

…扣 d eaA mdc% ，“卞 avvav^n .,, 

ker nv^ kea- 


ZjCVO, 


if (key != 0) { 

track.add(makeEvent(144,9,key, 100, i)); 
track.add(makeEvent(128,9,key, 100, i+1)); 


public MidiEvent makeEvent(int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage(); 
a•setMessage(comd, chan, one, two); 
event = new MidiEvent(a, tick); 

} catch(Exception e) {e.printStackTrace(); } 
return event; 


This 




' Make KOTt ON ay>d 
/ fiOT OFF events, av>d 
add *tV^cw *bo *bV>c Tvatk- 


} // close class 
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exercise: Which Layout? 



code goes wifli 
A^iicli layout? 

Five of the six screens below were made from one 
of the code fragments on the opposite page. Match 
each of the five code fragments with the layout that 
fragment would produce. 
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using swing 


Code Fragments 


O JFrame frame = new JFrame(); 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton (''tesuji"); 

JButton buttonTwo = new JButton (''watari ,r ); 

frame.getContentPane().add(BorderLayout.NORTH , panel); 

panel.add(buttonTwo); 

frame.getContentPane().add(BorderLayout.CENTER,button); 


© JFrame frame = new JFrame (); 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton (''tesuji"); 

JButton buttonTwo = new JButton (''watari ,r ); 
panel.add(buttonTwo); 

frame.getContentPane().add(BorderLayout.CENTER,button); 
frame.getContentPane().add(BorderLayout.EAST, panel); 


JFrame frame = new JFrame (); 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton (''tesuji"); 

JButton buttonTwo = new JButton (''watari ^); 
panel.add(buttonTwo); 

frame.getContentPane().add(BorderLayout.CENTER,button); 


O JFrame frame = new JFrame (); 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton (''tesuji"); 

JButton buttonTwo = new JButton (''watari ,r ); 
panel.add(button); 

frame.getContentPane().add(BorderLayout.NORTH,buttonTwo); 
frame.getContentPane().add(BorderLayout.EAST, panel); 


© JFrame frame = new JFrame (); 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton (''tesuji"); 

JButton buttonTwo = new JButton (''watari ,r ); 

frame.getContentPane().add(BorderLayout.SOUTH,panel); 

panel.add(buttonTwo); 

frame.getContentPane().add(BorderLayout.NORTH,button); 
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puzzle: crossword 


GUI 7.0 
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You can do it. 


Across 

I. Artist's sandbox 

4. Border’s catchall 

5. Java look 

9. Generic waiter 

II. A happening 

12. Apply a widget 

15. JPanel’s default 

16. Polymorphic test 


17. Shake it baby 
21. Lots to say 
23. Choose many 

25. Button’s pal 

26. Home of 
action Performed 


Down 

2. Swing’s dad 

3. Frame’s purview 

5. Help’s home 

6. More fun than text 

7. Component slang 

8. Romulin command 

9. Arrange 

10. Border’s top 


13. Manager’s rules 

14. Source’s behavior 

15. Border by default 

18. User’s behavior 

19. Inner’s squeeze 

20. Backstage widget 
22. Mac look 

24. Border's right 
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using swing 


Exercise Solutions 




O JFrame frame = new JFrame(); 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton (''tesuji"); 

JButton buttonTwo = new JButton (''watari"); 
panel.add(buttonTwo); 

frame.getContentPane().add(BorderLayout.CENTER,button); 



tesuji 




O JFrame frame = new JFrame (); 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton 「 tesuji"); 

JButton buttonTwo = new JButton (''watari"); 

frame.getContentPane().add(BorderLayout.NORTH,panel); 

panel.add(buttonTwo); 

frame.getContentPane().add(BorderLayout.CENTER,button); 



O JFrame frame = new JFrame (); 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton (''tesuji"); 

JButton buttonTwo = new JButton (''watari"); 

frame.getContentPane().add(BorderLayout.SOUTH,panel); 

panel.add(buttonTwo); 

frame.getContentPane().add(BorderLayout.NORTH,button); 



O JFrame frame = new JFrame (); 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton (''tesuji"); 

JButton buttonTwo = new JButton (''watari"); 
panel.add(button); 

frame.getContentPane().add(BorderLayout.NORTH,buttonTwo); 
frame.getContentPane().add(BorderLayout.EAST, panel); 



O JFrame frame = new JFrame (); 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray); 

JButton button = new JButton (''tesuji"); 

JButton buttonTwo = new JButton (''watari^); 
panel.add(buttonTwo); 

frame.getContentPane().add(BorderLayout.CENTER,button); 
frame.getContentPane().add(BorderLayout.EAST, panel); 


you are here ► 427 

































puzzle answers 
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14 serialization and file I/O 


Saving Objects 



Objects can be flattened and inflated. Objects have state and behavior. 
Behavior lives in the class, but state lives within each individual object. So what happens when 
it’s time to save the state of an object? If you’re writing a game, you’re gonna need a Save/ 
Restore Game feature. If you're writing an app that creates charts, you're gonna need a Save/ 
Open File feature. If your program needs to save state,you can do it the hard way, interrogating 
each object, then painstakingly writing the value of each instance variable to a file, in a 
format you create. Or, you can do it the easy 00 way — you simply freeze-dry/flatten/persist/ 
dehydrate the object itself, and reconstitute/inflate/restore/rehydrate it to get it back. But you’ll 
still have to do it the hard way sometimes, especially when the file your app saves has to be read 
by some other non-Java application, so we’ll look at both in this chapter. 
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saving objects 


Capture the Peat 
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You’ve made the perfect pattern. You want to save the pattern. 
You could grab a piece of paper and start scribbling it ( 
instead you hit the Save button (or choose Save from tl 
menu). Then you give it a name, pick a directory, 
and exhale knowing that your masterpiece won’t go 
out the window with the blue screen of death. 


You have lots of options for how to save the state of 
your Java program, and what you choose will probably 
depend on how you plan to use the saved state. Here 
are the options we’ll be looking at in this chapter. 

If your data will be used by only the Java 
program that generated it: 

① Use serialization 


Write a file that holds flattened (serialized) 
objects. Then have your program read the 
serialized objects from the file and inflate the 
back into living, breathing, heap-inhabiting objects. 


If your data will be used by other programs: 

② Write a plain text file 

Write a file, with delimiters that other programs can parse. 
For example, a tab-delimited file that a spreadsheet or 
database application can use. 

These aren’t the only options, of course. You can save data in any 
format you choose. Instead of writing characters, for example, 
you can write your data as bytes. Or you can write out any kind 
of Java primitive as a Java primitive — there are methods to write 
ints, longs, booleans, etc. But regardless of the method you use, 
the fundamental I/O techniques are pretty much the same: 
write some data to something, and usually that something is either 
a file on disk or a stream coming from a network connection. 
Reading the data is the same process in reverse: read some data 
from either a file on disk or a network connection. And of course 
everything we talk about in this part is for times when you aren’t 
using an actual database. 
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Saving State 

Imagine you have a program, say, a fantasy 
adventure game, that takes more than one 
session to complete. As the game progresses, 
characters in the game become stronger, weaker, 
smarter, etc., and gather and use (and lose) 
weapons. You don’t want to start from scratch 
each time you launch the game — it took you 
forever to get your characters in top shape for 
a spectacular battle. So, you need a way to save 
the state of the characters, and a way to restore 
the state when you resume the game. And since 
you’re also the game programmer, you want the 
whole save and restore thing to be as easy (and 
foolproof) as possible. 


① Option one 

Write the three serialized 
character objects to a file 

Create a file and write three serialized 
character objects. The file woiVt make 
sense if you try to read it as text ： 

"isrGameCharacter 

'^geSMUIpowerLjava/lang/ 

String; [weaponst [Ljava/lang/ 
String;xp2tlfur [Ljava.lang.String^^VA 
E {6xptbowtswordtdustsq M »tTrolluq~tb 
are handstbig axsq M xtMagicianuq M tspe 
llstinvisibility 


② Option two 

Write a plain text file 

Create a file and write three lines of text, 
one per character, separating the pieces 
of state with commas ： 

50,Elf,bow, sword,dust 
200,Troll,bare hands,big ax 
120,Magician,spells,invisibility 


GameCharacter 

int power 
String type 
Weapon[] weapons 

getWeapon() 

useWeapon() 

increasePower() 

II more 


J ma gine y 0u 

t e tW ~ 


barters to 


save 


••籲 


pov/er: 


50 




ZOO 


■type ： Troll 
weapons ： bare 


■type ： El-f 

weapons ： bow, 
y/o\rd, dus*t 


a 


a 


power 


: 110 


type ： Magidiar\ 
weapons ： spells, 


mvisi 


bili*ty 


The r : i 
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saving objects 


Writing a serialized object to a file 

Here are the steps for serializing (saving) an object. Don’t bother 
memorizing all this; we’ll go into more detail later in this chapter. 


匕 aw 二加 补 


o Moke a Fi I eOutputStrearn 

FileOutputStream filestream 


/ 

new FileOutputStream(^MyGame.ser"); 



to a " 


^ J , TWiS iS atWW 

tailed Aam” 0 以托 


❺ Write the object 


os.writeObject(characterOne); 
os.writeObject(characterTwo); 
os.writeObject(characterThree) 





dv\d 



Close the ObjectOutputStream 



驗 ㈣ 


cs "the ohes 
^hd the 
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Pata moves m streams from owe place to another. 


CoKiwectioji 
streams represent 
a coKiKiection 
to a source or 
destination (file, 
socket etc.) while 
chaiw streams 
can't connect OKI 
their own and must 
be chained to a 
cowwectiow stream. 

The Java I/O API has connection streams, that represent connections to destinations and 
sources such as files or network sockets, and chain streams that work only if chained to 
other streams. 

Often, it takes at least two streams hooked together to do something useful — one to 
represent the connection and another to call methods on. Why two? Because connection 
streams are usually too low-level. FileOutputStream (a connection stream), for example, 
has methods for writing bytes. But we don’t want to write bytes\ We want to write objects, so 
we need a higher-level chain stream. 

OK, then why not have just a single stream that does exactly what you want? One that lets 
you write objects but underneath converts them to bytes? Think good OO. Each class 
does one thing well. FileOutputStreams write bytes to a file. ObjectOutputStreams turn 
objects into data that can be written to a stream. So we make a FileOutputStream that lets 
us write to a file, and we hook an ObjectOutputStream (a chain stream) on the end of it. 

When we call writeObject() on the ObjectOutputStream, the object gets pumped into the 
stream and then moves to the FileOutputStream where it ultimately gets written as bytes 
to a file. 



The ability to mix and match different combinations of connection and chain streams 
gives you tremendous flexibility! If you were forced to use only a single stream class, you’d 
be at the mercy of the API designers, hoping they’d thought of everything you might ever 
want to do. But with chaining, you can patch together your own custom chains. 






you are here ► 433 


















serialized objects 

What really happens to an object 
whew ifs serialized? 


O Object on the heap 


© Object serialized 



Objects on the heap have state—the 
value of the object’s instance 
variables. These values make one 
instance of a class different from 
another instance of the same class. 


Serialized objects save the values 
of the instance variables, so that 
an identical instance (object) can be 
brought back to life on the heap. 










从 c stream- 




00100101 

01000110 


+ w，dth a^d heiahi ^ 

匕 lass -type is). 


foo.ser 

FileOutputStream fs = new FileOutputStream(' 、 foo• ser 〃）； 
ObjectOutputStream os = new ObjectOutputStream(fs); 
os.writeObject(myFoo); 


Foo myFoo = new Foo(); 
myFoo.setWidth(37); 
myFoo.setHeight(70); 


io il 3y)d icl1 ^ 
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Put what exactly ]S aw object's state? 
What needs to be saved? 

Now it starts to get interesting. Easy enough to save the primitive 
values 37 and 70. But what if an object has an instance variable 
that’s an object reference} What about an object that has five 
instance variables that are object references? What if those object 
instance variables themselves have instance variables? 

Think about it. What part of an object is potentially unique? 
Imagine what needs to be restored in order to get an object that’s 
identical to the one that was saved. It will have a different memory 
location, of course, but we don’t care about that. All we care about 
is that out there on the heap, we’ll get an object that has the same 
state the object had when it was saved. 




Brain Barbell 


What has to happen for the Car 
object to be saved in such a way 
that it can be restored back to its 
original state? 

Think of what — and how — you 
might need to save the Car. 

And what happens if an Engine 
object has a reference to a 
Carburator? And what’s inside the 
Tire [] array object? 


The Car object has two 



What does it take to 
save a Car object? 
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serialized objects 


When an object is serialized, all the objects 



String 1 col 


Collar 


㈣ 成 r 一 




it refers to from instance variables are also 
serialized. And all the objects those objects 
refer to are serialized. And all the objects those 
objects refer to are serialized... and the best 
part is, it happens automatically! 


Serialization saves tke 
entire object grapk 
AU objects referencect 
hy instance variables ， 
starting witk tke 
object Leing serializeci. 


When you save the Kennel, all of this is saved! 


bog[] 




^°9 广 ~\ 

> ike 〃) 

X f 


°^ ] arro^ 


This Kennel object has a reference to a Dog [] array object. The 
Dog [] holds references to two Dog objects. Each Dog object holds 
a reference to a String and a Collar object. The String objects 
have a collection of characters and the Collar objects have an int. 


Collar 


String 


d Og ob *^ 
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If you wawt your class to be serializable, 
implement 


Serializable 


The Serializable interface is known as a marker or tog'interface, 
because the interface doesn’t have any methods to implement. Its 
sole purpose is to announce that the class implementing it is, well, 
serializable. In other words, objects of that type are saveable through 
the serialization mechanism. If any superclass of a class is serializable, 
the subclass is automatically serializable even if the subclass doesn’t 
explicitly declare implements Serializable. (This is how interfaces always 

work. If your superclass “IS-A” Serializable, you are too). . .q-t 

w £a\\ at vwt〆. 

objectOutputStream.writeObject (myBox) ; ° r ^ 1 ' 


import java.io.*; 


w' 一 . 


so 


public class Box 


implements Se 
、 - -- - 


rializable { 

- ， 


Ko -etWs to • 、六以:二 it ? 丄 


private int width;. . 

>rivate int height y these -two values will be 


saved 


public void setWidth(int w) { 
width = w; 

} 

public void setHeight(int h) 
height = h; 


public static void main (String[] args) { 

Box myBox = new Box(); 

myBox.setWidth(50); 

myBox. setHeight (20) ; 0 ^> C y-at»o^s 


tWrow C 叫 Ws. 



r 、 ^ ooSCC 


y\C>m 


try { 

FileOutputStream fs = new FileOutputStream(' 、 foo.ser 〃）； 
ObjectOutputStream os = new ObjectOutputStream(fs); 
os.writeObject(myBox); 
os.close(); 

} catch(Exception ex) { 
ex.printstackTrace(); 





Tcl < H io 


Wlri ic ih c 




you are here ► 437 









serialized objects 


Serialization is all or nothing. 


Can you imagine what would 
happen if some of the object’s 
state didn’t save correctly? 


Eeewww! That 
creeps me out just thinking 
about it! Like, what if a Dog comes 
back with no weight. Or no ears. Or 
the collar comes back size 3 instead 
of 30. That just catVt be allowed! 






import java.io.*; 


^ 、 ?0Y\d objcdts tBY\ be scvializ^d- 


public class Pond implements Serializable { 


private Duck duck = new Duck(); 


public static void main (String[] args) { 

Pond myPond = new Pond(); 
try { 

FileOutputStream fs = new FileOutputStream(' 、 Pond.ser 〃）； 
ObjectOutputStream os = new ObjectOutputStream(fs); 

os . writeOb ject (myPondfT^ y ou scv-ializ^ j / D , 

os. close (); oWti\ ih j "1 ； d ^ P ?： d 

} catch(Exception ex) { 
ex.printStackTrace(); 


Either the entire 
object graph is 
serialized correctly 
or serialization fails 

You can’t serialize 
a Pond object if 
its Duck instance 
variable refuses to 
be serialized (by 
not implementing 
Serializable). 






tlass Pov\d ： 




f kes// Dudk is hot senaliz^ble/ 

public class Duck { doesh i imPlcrhCht Serializable, 

// duck code here ? scv-iali^ a 

} 吒’丨七心 “ 5 the 

Pohd s Pudk ihs-bhdc variable 
^y\ t be saved. 


% java 
j ava. i ( 


at pond.main(Pona.j 
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0 



Ifs hopeless, 
then? I’m completely 
screwed if the idiot who 
wrote the class for my instance 
variable forgot to make it 
Serializable? 




Mark an instance variable as transient 
if it can’t (or shouldn’t) be saved. 

If you want an instance variable to be skipped by the 
serialization process, mark the variable with the transient 
keyword. 


be saved as ⑼七 

d 叱 mg scvializ^tioh. 


import java.net.*; 

class Chat implements Serializable { 

transient String currentID; 

^ 一 _ ■ 

String userName; 

// more code 



If you have an instance variable that can’t be saved because 
it isn’t serializable, you can mark that variable with the 
transient keyword and the serialization process will skip right 
over it. 


So why would a variable not be serializable? It could be 
that the class designer simply forgot to make the class 
implement Serializable. Or it might be because the object 
relies on runtime-specific information that simply can’t be 
saved. Although most things in the Java class libraries are 
serializable, you can’t save things like network connections, 
threads, or file objects. They’re all dependent on (and 
specific to) a particular runtime ‘experience’. In other words, 
they’re instantiated in a way that’s unique to a particular run 
of your program, on a particular platform, in a particular 
JVM. Once the program shuts down, there’s no way to bring 
those things back to life in any meaningful way; they have to 
be created from scratch each time. 
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ttereiarenp 

Dumb Questions 

If serialization is so important, 
why isn't it the default for all classes? 
Why doesn’t class Object implement 
Serializable, and then all subclasses 
will be automatically Serializable. 

Even though most classes will, 
and should, implement Serializable, 
you always have a choice. And you 
must make a conscious decision on 
a class-by-class basis, for each class 
you design, to 'enable' serialization 
by implementing Serializable. 

First of all, if serialization were the 
default, how would you turn it off? 
Interfaces indicate functionality, not 
a lack of functionality, so the model 
of polymorphism wouldn't work 
correctly if you had to say/Mmplements 
NonSerializable”to tell the world that 
you cannot be saved. 

Why would I ever write a class 
that was^t serializable? 

There are very few reasons, but 
you might, for example, have a security 
issue where you don’t want a password 
object stored. Or you might have an 
object that makes no sense to save, 
because its key instance variables are 
themselves not serializable, so there’s 
no useful way for you to make your 
class serializable. 


If a class I’m using isn’t 
serializable, but there’s no good 
reason (except that the designer just 
forgot or was stupid), can I subclass 
the 'bacT class and make the subclass 
serializable? 


Yes! If the class itself is 
extendable (i.e. not final), you can 
make a serializable subclass, and just 
substitute the subclass everywhere 
your code is expecting the superclass 
type. (Remember, polymorphism 
allows this.) Which brings up another 
interesting issue: what does it mean if 
the superclass is not serializable? 

You brought it up: what does it 
mean to have a serializable subclass 
of a non-serializable superclass? 

First we have to look at what 
happens when a class is deserialized, 
(we’ll talk about that on the next few 
pages). In a nutshell, when an object 
is deserialized and its superclass is not 
serializable, the superclass constructor 
will run just as though a new object of 
that type were being created. If there’s 
no decent reason for a class to not 
be serializable, making a serializable 
subclass might be a good solution. 

Whoa! I just realized 
something big... if you make a 
variable'transient; this means the 
variable’s value is skipped over 
during serialization.Then what 
happens to it? We solve the problem 
of having a non-serializable instance 
variable by making the instance 
variable transient, but don’t we NEED 
that variable when the object is 
brought back to life? In other words, 
isn’t the whole point of serialization 
to preserve an object’s state? 

J\l Yes,this is an issue, but 
fortunately there’s a solution. If you 
serialize an object, a transient reference 
instance variable will be brought back 


as null, regardless of the value it had 
at the time it was saved.That means 
the entire object graph connected to 
that particular instance variable won’t 
be saved.This could be bad, obviously, 
because you probably need a non-null 
value for that variable. 

You have two options: 

1) When the object is brought back, 
reinitialize that null instance variable 
back to some default state.This 
works if your deserialized object isn’t 
dependent on a particular value for 
that transient variable. In other words, 
it might be important that the Dog 
have a Collar, but perhaps all Collar 
objects are the same so it doesn’t 
matter if you give the resurrected Dog 
a brand new Collar; nobody will know 
the difference. 

2) If the value of the transient variable 
does matter (say, if the color and design 
of the transient Collar are unique for 
each Dog) then you need to save the 
key values of the Collar and use them 
when the Dog is brought back to 
essentially re-create a brand new Collar 
that’s identical to the original. 

What happens if two objects in 
the object graph are the same object? 
Like, if you have two different Cat 
objects in the Kennel, but both Cats 
have a reference to the same Owner 
object. Does the Owner get saved 
twice? I’m hoping not. 

Excellent question! Serialization 
is smart enough to know when two 
objects in the graph are the same. In 
that case, only one of the objects is 
saved, and during deserialization, any 
references to that single object are 
restored. 
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deserialization: restoring m object 

The whole point of serializing an object is so that you can 
restore it back to its original state at some later date, in a 
different ‘run’ of the JVM (which might not even be the same 
JVM that was running at the time the object was serialized). 
Deserialization is a lot like serialization in reverse. 


serialized 


dcs ^li^d 



屬% 


o 




O Make a FilelnputStream r • , u 

- 4^ c / 此 7 0VA 3 

FilelnputStream filestream = new FilelnputStream (''MyGame • ser"); 

\ ^ io ^ 故您—捣心 


❺ Make an ObjectlnputStream 


Ob jectlnputS tream os = new ObjectlnputStream (files tream); 

經 1 7 


a 


❺ read the objects 


Object one = 
Object two = 
Object three 


os.readObject(); 
os.readObject(); 
= os.readObject() 


the sStmc ovdev m whi£h 11 - • • 


art IT 7T^ ^ 


iicv\. You'll 
rnoirc 


o Cast the objects 


GameCharacter elf = (GameCharacter) one; 

GameCharacter troll = (GameCharacter) two; AOWtt\} 

GameCharacter magician = (GameCharacter) three;T C 士 ^ 


: v^sia 






Close the ObjectlnputStream 

os.close () 

Closmg -the ^ n I 


closes the ohes 

“d the 
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deserializing objects 


What happens during deserialization? 


When an object is deserialized, the JVM attempts to bring 
the object back to life by making a new object on the heap 
that has the same state the serialized object had at the time it 
was serialized. Well, except for the transient variables, which 
come back either null (for object references) or as default 
primitive values. 



01101001 

01101110 

01 



object is read as bytes 


is read by 



FilelnputStream 
(a connection stream) 





class is found and loaded, saved 
instance variables reassigned 


is chained to 



ObjectlnputStream 
(a chain stream) 


o The object is read from the stream. 

❺ The JVM determines (through info stored with 
the serialized object) the object's class type. 

❺ The JVM attempts to find and load the ob¬ 
ject's class. If the JVM cant find and/or load 
the class, the JVM throws an exception and 
the deserialization fails. 

o A new object is given space on the heap, but 
the serialized objects constructor does 
NOT run! Obviously, if the constructor ran, it 
would restore the state of the object back 
to its original new* state, and that's not what 
we want. We want the object to be restored 
to the state it had when it was serialized, not 
when it was first created. 


Jk 

-o 

Object 
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❺ If the object has a non-serializable class 
somewhere up its inheritance tree, the 
constructor for that non-serializable class 
will run along with any constructors above 
that (even if they're serializable). Once the 
constructor chaining begins, you cant stop it, 
which means all superclasses, beginning with 
the first non-serializable one, will reinitialize 
their state. 

o The object s instance variables are given the 
values from the serialized state. Transient 
variables are given a value of null for object 
references and defaults (0, false, etc.) for 
primitives. 


^Jiereiqre^np 

Dumb Questions 

^^,-Why doesn’t the class get saved as part of the ob¬ 
ject? That way you don't have the problem with whether 
the class can be found. 


argument, and if the JVM receiving the call doesn’t have 
the class, it can use the URL to fetch the class from the 
network and load it, all automatically. (We'll talk about RMI 
in chapter 17.) 


-Sure, they could have made serialization work that 
way. But what a tremendous waste and overhead. And 
while it might not be such a hardship when you’re using 
serialization to write objects to a file on a local hard drive, 
serialization is also used to send objects over a network 
connection. If a class was bundled with each serialized 
(shippable) object, bandwidth would become a much larger 
problem than it already is. 

For objects serialized to ship over a network, though, there 
actually is a mechanism where the serialized object can be 
'stamped’with a URL for where its class can be found.This 
is used in Java’s Remote Method Invocation (RMI) so that 
you can send a serialized object as part of, say, a method 


^^•What about static variables? Are they serialized? 


A ： 


Nope. Remember, static means "one per class” not 
"one per object’:Static variables are not saved, and when an 
object is deserialized, it will have whatever static variable 
its class currently has.The moral: don’t make serializable ob¬ 


jects dependent on a dynamically-changing static variable! 
It might not be the same when the object comes back. 
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Saving awd restoring the game characters 


import java.io.*; 

public class GameSaverTest { Make some Aavatten. 

public static void main(String[] args) { 

GameCharacter one = new GameCharacter(50, ''Elf' new String[] {''bow' ''sword' ''dust"}); 
GameCharacter two = new GameCharacter(200, ''Troll' new String[] {''bare hands' ''big ax"}); 
GameCharacter three = new GameCharacter(120, ''Magician", new String[] {''spells", ''invisibility"}); 

// imagine code that does things with the characters that might change their state values 


try { 

ObjectOutputStream os = new ObjectOutputStream(new FileOutputStream(''Game.ser")); 

os.writeObject(one); 

os.writeObject(two); 

os.writeObject(three); 

os.closed ; 

} catch(IOException ex) { 
ex.printStackTrace(); 

one = null; set to ^ull so v/c 七 

two = null; 士 〆 aacss ttc V^ca\>* 

three = null; 


Wow wd them bad ih “O 你七 he 

try { 厶 

ObjectlnputStream is = new ObjectlnputStream(new FileInputStream(''Game.ser /, )); 
GameCharacter oneRestore = (GameCharacter) is.readObject(); 

GameCharacter twoRestore = (GameCharacter) is.readObject(); 

GameCharacter threeRestore = (GameCharacter) is.readObject(); 

Vt worked- 


System.out.println(''One's type: '、+ oneRestore.getType()); 
System.out.println(''Two ; s type: '、 + twoRestore.getType()); 
System.out.println(''Three's type: '' + threeRestore.getType()) 
catch(Exception ex) { 
ex.printStackTrace(); 


*t 。 


sec 


pov/ev: 


弓 0 


% java GameSaver 
Elf 


Troll 


iyfc ： Tvoll 
y/capoir\s ： bav-c 
bi^ 


Magician 


o 


bjec' 


•tyfc ： El-f 

weapons ： bov/, 
sy/ovd, dus-t 
、二 ^ 
object 


pov/ev: IZO 
iyfc ： Ma^itia^ 
y/capoir\s ： spells, 
ihvisibili'ty 
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The frameCharacter class 

import java.io.*; 

public class GameCharacter implements Serializable { 
int power; 

String type; 

String[] weapons; 

public GameCharacter(int p, String t, String[] w) { 
power = p; 
type = t; 
weapons = w; 


public int getPower() { 
return power; 


public String getType() { 
return type; 


public String getWeapons() { 

String weaponList = 

for (int i = 0; i < weapons.length; i++) { 
weaponList += weapons [i] + 

} 

return weaponList; 


TW»s »s a 6lass jus-t ^ 

Wt ^ll leave to 

you io 
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Object Serialization 

_BULLET POINTS^%>_ 

> You can save an object’s state by serializing the object. 

> To serialize an object, you need an ObjectOutputStream (from the 
java.io package) 

> Streams are either connection streams or chain streams 

> Connection streams can represent a connection to a source or 
destination, typically a file, network socket connection, or the 
console. 

> Chain streams cannot connect to a source or destination and must 
be chained to a connection (or other) stream. 

> To serialize an object to a file, make a FileOuputStream and chain it 
into an ObjectOutputStream. 

> To serialize an object, call writeObject(theObject) on the 
ObjectOutputStream. You do not need to call methods on the 
FileOutputStream. 

> To be serialized, an object must implement the Serializable interface. 
If a superclass of the class implements Serializable, the subclass will 
automatically be serializable even if it does not specifically declare 
implements Serializable. 

> When an object is serialized, its entire object graph is serialized. That 
means any objects referenced by the serialized object’s instance 
variables are serialized, and any objects referenced by those 
objects...and so on. 

> If any object in the graph is not serializable, an exception will be 
thrown at runtime, unless the instance variable referring to the object 
is skipped. 

> Mark an instance variable with the transient keyword if you want 
serialization to skip that variable. The variable will be restored as null 
(for object references) or default values (for primitives). 

> During deserialization, the class of all objects in the graph must be 
available to the JVM. 

> You read objects in (using readObject()) in the order in which they 
were originally written. 

> The return type of readObject() is type Object, so deserialized 
objects must be cast to their real type. 

> Static variables are not serialized! It doesn’t make sense to save 
a static variable value as part of a specific object’s state, since all 
objects of that type share only a single value—the one in the class. 
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Writing a String to a Text File 

Saving objects, through serialization, is the easiest way to save and 
restore data between runnings of a Java program. But sometimes you 
need to save data to a plain old text file. Imagine your Java program 
has to write data to a simple text file that some other (perhaps non- 
Java) program needs to read. You might, for example, have a servlet 
(Java code running within your web server) that takes form data the 
user typed into a browser, and writes it to a text file that somebody else 
loads into a spreadsheet for analysis. 

Writing text data (a String, actually) is similar to writing an object, 
except you write a String instead of an object, and you use a 
FileWriter instead of a FileOutputStream (and you don’t chain it to an 
ObjectOutputStream). 


To write a serialized object ： 

objectOutputStream.writeObject(someObject); 

To write a String ： 

fileWri ter. write (''My first String to save ’’）； 


lVha*t 

miah*t look ike i-f you y/v-o*tc i*t 
out as a huma^-\rcadablc 乂七 -file- 


50,Elf,bow, sword,dust 
200,Troll,bare hands,big ax 
ISO,Magician,spells,invisibility 



import java.io.*; 




class WriteAFile { 

public static void main (String[] args) { 




try { 

FileWriter writer = new FileWriter (''Foo. txt^); 




writer.write (''hello foo !〃）； 


The wh^O method iakes 

a c^tlrihg 


writer. close () ; 

^ Close ，i whe, youVc dec/ 


} catch(IOException ex) { 
ex.printStackTrace(); 
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writing a text file 


Text File Example: e - Flashcards 

Remember those flashcards you used in school? Where you 
had a question on one side and the answer on the back? 
They aren’t much help when you’re trying to understand 
something, but nothing beats 'em for raw drill-and-practice 
and rote memorization. When you have to burn in a fact. And 
they’re also great for trivia games. 

We’re going to make an electronic version that has three 
classes: 

1) QuizCardBuilder, a simple authoring tool for creating and 
saving a set of e-Flashcards. 

2) QuizCardPlayer, a playback engine that can load a 
flashcard set and play it for the user. 

3) QuizCard, a simple class representing card data. We’ll 

walk through the code for the builder and the player, and 
have you make the QuizCard class yourself, using this - - : 


0 0 0 Quiz Card Player 

File 

What happens if you call 
EJBObject.getPrimaryKeyO on a 
Session bean's remote reference? 


’ Show Answer x 


QuizCardPlayer 

Has a File menu with a 、、 Load 〃 option for loading a 
set of cards from a text file. 
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QuizCardBuilder 

Has a File menu with a 、、 5ave 〃 option for saving 
the current set of cards to a text file. 






ba^k 




QuizCard 

QuizCard(q, a) 


question 

answer 


getQuestion() 

getAnswer() 























Quiz Card Guilder (code outline) 


serialization and file I/O 


public class QuizCardBuilder { 

public void go(){ ^ids a,d delays ^ ^ 

// build and display gui a 於 d vc^stcv-m^ c 


Irmcv* tlass 

private class NextCardListener implements ActionListener { 
public void actionPerformed (ActionEvent ev) { 

// add the current card to the list and clear the text areas 


u U C^d! bvAttoh 


|rmcv* c\diss 

private class SaveMenuListener implements ActionListener { 
public void actionPerformed (ActionEvent ev) { 

// bring up a file dialog box ^ Ue 

// let the user name and save the set 

M w w o 耗 


tVuahtury, QU Un Ct (,,k 

山 4 u| es , S 1 THV ^ 


|wcv- tlass 

private class NewMenuListener implements ActionListener { 
public void actionPerformed (ActionEvent ev) { 

// clear out the card list, and clear out the text areas 


• (X 七抑 

州㈣ ( so out t 

St; “ ㈣ s ). 


private void saveFile(File file) { 

// iterate through the list of cards, and write each one out to a text file 
// in a parseable way (in other words, with clear separations between parts) 


Called 1 >y *tKc SaveMwUs 七 cmv; 
docs *tKc actual ^'»lc _»七巧 
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Quiz Card Builder code 


import j ava.util.^; 
import j ava.awt.event.^; 
import j avax.swing.^; 
import java.awt.*; 
import j ava.io.^; 

public class QuizCardBuilder { 

private JTextArea question; 
private JTextArea answer; 
private ArrayList<QuizCard> cardList; 
private JFrame frame; 


public static void main (String[] args) { 

QuizCardBuilder builder = new QuizCardBuilder(); 
builder.go(); 


public void go () { 

// build gui 

frame = new JFrame (''Quiz Card Builder ’’）； 

JPanel mainPanel = new JPanel(); 

Font bigFont = new Font (''sanserif” ， Font.BOLD, 24); 
question = new JTextArea(6,20); 
question.setLineWrap(true); 
question.setWrapStyleWord(true); 
question.setFont(bigFont); 

JScrollPane qScroller = new JScrollPane(question); 
qScroller.setVerticalScrollBarPolicy(ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS); 
qScroller.setHorizontalScrollBarPolicy(ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER); 

answer = new JTextArea(6,20); 
answer.setLineWrap(true); 
answer.setWrapStyleWord(true); 
answer.setFont(bigFont); 

JScrollPane aScroller = new JScrollPane(answer); 

aScroller.setVerticalScrollBarPolicy(ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS); 
aScroller.setHorizontalScrollBarPolicy(ScrollPaneConstants.HORIZONTAL SCROLLBAR NEVER); 


鍵 


JButton nextButton = new JButton (''Next Card ’’）； 

cardList = new ArrayList<QuizCard>(); 

JLabel qLabel = new JLabel (''Question :〃）； 

JLabel aLabel = new JLabel (''Answer :〃）； 

mainPanel.add(qLabel); 
mainPanel.add(qScroller); 
mainPanel.add(aLabel); 
mainPanel.add(aScroller); 
mainPanel.add(nextButton); 

nextButton.addActionListener(new NextCardListener()); 
JMenuBar menuBar = new JMenuBar(); 

JMenu fileMenu = new JMenu (''File"); 

JMenuItem newMenuItem = new JMenuItem(''New"); 
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JMenuItem saveMenuItem = new JMenuItem(''Save"); 
newMenuItem.addActionListener(new NewMenuListener() 




saveMenuItem.addActionListener(new SaveMenuListener()); 
fileMenu. add (newMenuItem); 
fileMenu. add (saveMenuItem); 
menuBar. add (fileMenu); 
frame.setJMenuBar(menuBar); 
frame.getContentPane().add(BorderLayout.CENTER, mainPanel); 
frame.setSize(500,600); 
frame.setVisible(true); 


Fu { « u / ^ ^ File 

‘ w 、总 r 之 f - 


public class NextCardListener implements ActionListener { 

public void actionPerformed(ActionEvent ev) { 


QuizCard card = new QuizCard(question.getText() 
cardList.add(card); 
clearCard(); 


answer.getText() 


public class SaveMenuListener implements ActionListener { 

public void actionPerformed(ActionEvent ev) { 

QuizCard card = new QuizCard(question.getText (), answer.getText()); 
cardList. add (card) ; .\. s 0Y \ 

— looses save .^4 avxd 


c class NewMenuListener implements Ac tionLi s ten^ ''f 

mblic void actionPerformed(ActionEvent ev) { 
cardList.clear(); 



JFileChooser file Save = new JFileChooser (); 认 . u o 

fileSave. showSaveDialog (frame) ; 

saveFile (fileSave. getSelectedFile ()); i --— 一 w 、 


二 a,d 


clearCard (); 


private void clearCard () { 
question. setText 
answer. setText 
question.requestFocus(); 




ar 

WcW 'o' 


r x ^ ^ 咖 




private void saveFile (File file) { 

try { 

BufferedWriter writer = new BufferedWriter(new FileWriter(file) 



for (QuizCard card : cardList) { 

writer .write (card. getQuest ion () + 
writer .write (card. getAnswer () + ''\n"); 

} 

writer.close(); 


catch(IOException ex) { 

System, out .println ( x 'couldn , t write the cardList out ’’）； 
ex.printStackTrace(); 



add 9 hewl ⑽ 
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writing files 


The 


java.io.File 


class 


The java.io.File class represents a file on disk, but doesn’t 
actually represent the contents of the file. What? Think of 
a File object as something more like a pathname of a file 
(or even a directory) rather than The Actual File Itself. 
The File class does not, for example, have methods for 
reading and writing. One VERY useful thing about a File 
object is that it offers a much safer way to represent a 
file than just using a String file name. For example, most 
classes that take a String file name in their constructor 
(like FileWriter or FilelnputStream) can take a File 
object instead. You can construct a File object, verify 
that you’ve got a valid path, etc. and then give that File 
object to the FileWriter or FilelnputStream. 


A File object represents the name 
and path of a file or directory on 
disk, for example: 

/Users/Kathy/Data/GameFile.txt 

But it does NOT represent，or give 
you access to, the data in the file! 


Some things you can do with a File object: 

① Make a File object representing an 
existing file 

File f = new File (''MyCode. txt"); 

@ Make a new directory 

File dir = new File (''Chapter7"); 
dir.mkdir(); 


⑧ List the contents of a directory 

if (dir.isDirectory()) { 

String[] dirContents = dir.list(); 
for (int i = 0; i < dirContents.length; i++) { 
System.out.println(dirContents[i]); 


@ Set the absolute path of a file or directory 

System.out.println(dir.getAbsolutePath()); 


⑤ Delete a file or directory (returns true if 
successful) 

boolean isDeleted = f.delete(); 


7340 
fort H 其 



^ add^ss \S NOT 

sa^c as 今 al 

Wc! A ^ IS 

Wcc a street addvess … 

I ^ ^ 

a^d UaW a 




GameFile.txt 


50,Elf,bow, sword,dust 
200,Troll,bare hands,big ax 
120,Magician,spells,invisibility 
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The beauty of buffers 

If there were no buffers, it would be like 
shopping without a cart. You'd have to 
carry each thing out to your car, one soup 
can or toilet paper roll at a time. 



㈣ 5 ㈣ i 


String is put into a buffer When the buffer is full, the 

with other Strings Strings are all written to 


u 


Boulder 

String 


”_^ “Boulder” “Aspen” 

is written to “Denver” 

BufferedWriter 
(a chain stream that 
works with characters) 


is chained to 


(a connection stream 
that writes characters 
as opposed to bytes) 


''Aspen Denver Boulder" 


FileWriter 





File 


BufferedWriter writer = new BufferedWriter(new FileWriter(aFile)) 


The cool thing about buffers is that they’re much more efficient than 
working without them. You can write to a file using FileWriter alone, by 
calling write (someString), but FileWriter writes each and every thing you 
pass to the file each and every time. That’s overhead you don’t want or 
need, since every trip to the disk is a Big Deal compared to manipulating 
data in memory. By chaining a BufferedWriter onto a FileWriter, the 
BufferedWriter will hold all the stuff you write to it until it’s full. Only when 
the buffer is full will the FileWriter actually be told to write to the file on disk. 


^ obi e£i we1l 


If you do want to send data before the buffer is full, you do have control. 
Just Flush It. Calls to writer.flush () say, “send whatever’s in the buffer, now\ 
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reading files 


Reading from a Text File 

Reading text from a file is simple, but this time we’ll use a File 
object to represent the file, a FileReader to do the actual reading, 
and a BufferedReader to make the reading more efficient. 

The read happens by reading lines in a while loop, ending the loop 
when the result of a readLine() is null. That’s the most common 
style for reading data (pretty much anything that’s not a Serialized 
object): read stuff in a while loop (actually a while loop test ), 
terminating when there’s nothing left to read (which we know 
because the result of whatever read method we’re using is null). 




import java.io. 




ov ■ 七， 


A -file v/i*th *two I'mcs of *tc 乂 t 



MyText.txt 


class ReadAFile { 

public static void main (String[] args) { 


try { 

File myFile 




new File (''MyText. txt") 




FileReader fileReader = new FileReader (myFile); 


BufferedReader reader = new 


Make a 咖⑼二⑽ 

String line = null; 


BufferedReader (fileReader) 



while ((line = reader.readLine()) != null) { 

System.out.println(line); 


reader.close(); 

} catch(Exception ex) { 

ex.printStackTrace(); 


' 》， ^ d j 




^ siill li 


hes 
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Quiz Card Player (code outlme) 

public class QuizCardPlayer { 

public void go() { 

// build and display gui 

} 

class NextCardListener implements ActionListener { 
public void actionPerformed (ActionEvent ev) { 

//if this is a question, show the answer, otherwise show next question 
// set a flag for whether we’re viewing a question or answer 


class OpenMenuListener implements ActionListener { 
public void actionPerformed (ActionEvent ev) { 

// bring up a file dialog box 

// let the user navigate to and choose a card set to open 


private void loadFile(File file) { 

// must build an ArrayList of cards, by reading them from a text file 
// called from the OpenMenuListener event handler, reads the file one line at a time 
// and tells the makeCard() method to make a new card out of the line 
// (one line in the file holds both the question and answer, separated by a “/ ’） 


private void makeCard(String lineToParse) { 

// called by the loadFile method, takes a line from the text file 
// and parses into two pieces — question and answer — and creates a new QuizCard 
// and adds it to the ArrayList called CardList 
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Quiz Card Player code 


import j ava.util.^; 
import j ava.awt.event.^; 
import j avax.swing.^; 
import java.awt.*; 
import j ava.io.^; 

public class QuizCardPlayer { 

private JTextArea display; 
private JTextArea answer; 
private ArrayList<QuizCard> cardList; 
private QuizCard currentCard; 
private int currentCardlndex; 
private JFrame frame; 
private JButton nextButton; 
private boolean isShowAnswer; 


public static void main (String[] args) { 

QuizCardPlayer reader = new QuizCardPlayer(); 
reader.go(); 

} 

public void go () { 

// build gui 

frame = new JFrame (''Quiz Card Player ’’）； 

JPanel mainPanel = new JPanel(); 

Font bigFont = new Font (''sanserif” ， Font.BOLD, 24); 

display = new JTextArea(10,20); 
display.setFont(bigFont); 

display.setLineWrap(true); 
display.setEditable(false); 

JScrollPane qScroller = new JScrollPane(display); 

qScroller.setVerticalScrollBarPolicy(ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS); 
qScroller.setHorizontalScrollBarPolicy(ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER); 
nextButton = new JButton (''Show Question ’’）； 
mainPanel.add(qScroller); 
mainPanel.add(nextButton); 

nextButton.addActionListener(new NextCardListener()); 

JMenuBar menuBar = new JMenuBar(); 

JMenu fileMenu = new JMenu (''File"); 

JMenuItem loadMenuItem = new JMenuItem(''Load card set ’’）； 
loadMenuItem.addActionListener(new OpenMenuListener()); 
fileMenu. add (loadMenuItem); 
menuBar. add (fileMenu); 
frame.setJMenuBar(menuBar); 

frame.getContentPane().add(BorderLayout.CENTER, mainPanel); 
frame.setSize(640,500); 
frame.setVisible(true); 

} // close go 


士 j 咖 ’ 




lh 9 special 
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public class NextCardListener implements ActionListener { 
public void actionPerformed(ActionEvent ev) { 
if (isShowAnswer) { 

// show the answer because they've seen the question 
display.setText(currentCard.getAnswer()); 
nextButton. setText (''Next Card"); 
isShowAnswer = false; 

} else { 

// show the next question 
if (currentCardlndex < cardList.size()) { 

showNextCard(); 


-the 




} else { 

// there are no more cards! 
display • setText (''That was last card ’’）； 
, nextButton.setEnabled(false); 


public class OpenMenuListener implements ActionListener 
public void actionPerformed(ActionEvent ev) { 
JFileChooser fileOpen = new JFileChooser(); 
fileOpen. showOpenDialog (frame); 
loadFile (fileOpen. getSelectedFile ()); 



, c ， 以的 W 


private void loadFile (File file) 


cardList = new ArrayList<QuizCard>(); 
try { 

BufferedReader reader = new BufferedReader(new FileReader(file)) 
String line = null; 
while ( (line = reader.readLine() 
makeCard(line); 


null) 


reader.close() 


catch(Exception ex) { 

System, out .println ( x 'couldn , t read the card file”) 
ex.printStackTrace(); 


// now time to start by showing the first card 
showNextCard(); 


W to ^ Vt 


private void makeCard(String lineToParse) { 

String [ ] result = lineToParse • split (''/’’）； 

QuizCard card = new QuizCard(result[0], result[1]); 
cardList.add(card); 

System, out .println (''made a card"); 

} 

private void showNextCard ( ) { 

currentCard = cardList.get(currentCardlndex); 
currentCardIndex++; 

display.setText(currentCard.getQuestion()); 
nextButton. setText (''Show Answer ”）； 
isShowAnswer = true; 



|' me tov-v-cspoy\ds io d 

6dv~d) bu*t v/c *to pav*sc ou-b 
: ,or. and ansy/cv- as separate 
■V, c gbrM spl*»tO to Weak tVic 

*tv/o tokens (one ^ r? 七] 0 广 

oY\t -fov- air\sv/cv). VVc II look at 
0 mc*tV)od or\ 


} // close class 
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parsing Strings with split() 

Parsing with String splitO 


Imagine you have a flashcard like this: 



Saved in a question file like this: 


What is blue + yellow?/green 
What is red + blue?/purple 





How do you separate the question and answer? 

When you read the file, the question and answer are smooshed 
together in one line, separated by a forward slash V” (because 
thafs how we wrote the file in the QuizCardBuilder code). 


String split() lets you break a String into pieces. 

The split() method says, ''give me a separator, and ril break out all 
the pieces of this String for you and put them in a String array." 



token 1 separator token 2 


String toTest = ''What is blue + yellow?/green 
String[] result = toTest• split ('、"）； 
for (String token:result) { 

System.out.printin(token); 


S 



[he splitO method iakcs the M / w I i 

what wcVc usi， 9 it U ,1 " i th ^ 

t). “his ▲ 
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^^tfcereiEirejiP 

Dumb Questions 

^^:OK , 丨 look in the API and there are about five 
million classes in the java.io package. How the heck ck 
you know which ones to use? 

A- 

^L-The I/O API uses the modular'chaining'concept so 
that you can hook together connection streams and cha 
streams (also called 'filter’ streams) in a wide range of 
combinations to get just about anything you could want 

The chains don’t have to stop at two levels; you can hook 
multiple chain streams to one another to get just the rig 
amount of processing you need. 

Most of the time, though, you’ll use the same 
small handful of classes. If you’re writing text files, 
BufferedReader and BufferedWriter (chained to FileRead 
and FileWriter) are probably all you need. If you’re writing 
serialized objects,you can use ObjectOutputStream and 
ObjectlnputStream (chained to FilelnputStream and 
FileOutputStream). 

In other words, 90% of what you might typically do with 
Java I/O can use what we’ve already covered. 

What about the new I/O nio classes added in 1.4? 

-The java.nio classes bring a big performance 
improvement and take greater advantage of native 
capabilities of the machine your program is running 
on. One of the key new features of nio is that you have 
direct control of buffers. Another new feature is non- 
blocking I/O, which means your I/O code doesn’t just sit 
there, waiting, if there’s nothing to read or write. Some 
of the existing classes (including FilelnputStream and 
FileOutputStream) take advantage of some of the new 
features, under the covers.The nio classes are more 
complicated to use, however, so unless you really need the 
new features, you might want to stick with the simpler 
versions we’ve used here. Plus, if you’re not careful, nio can 
lead to a performance loss. Non-nio I/O is probably right 
for 90% of what you’ll normally do, especially if you’re just 
getting started in Java. 

But you can ease your way into the nio classes, by using 
FilelnputStream and accessing its channel through the 
getChannelO method (added to FilelnputStream as of 
version 1.4). 



■ To write a text file, start with a FileWriter 
connection stream. 

■ Chain the FileWriter to a BufferedWriter for 
efficiency. 

■ A File object represents a file at a particular 
path, but does not represent the actual 
contents of the file. 

■ With a File object you can create, traverse, 
and delete directories. 

■ Most streams that can use a String filename 
can use a File object as well, and a File object 
can be safer to use. 

■ To read a text file, start with a FileReader 
connection stream. 

■ Chain the FileReader to a BufferedReader for 
efficiency. 

■ To parse a text file, you need to be sure the 
file is written with some way to recognize the 
different elements. A common approach is to 
use some kind of character to separate the 
individual pieces. 

■ Use the String split() method to split a String 
up into individual tokens. A String with one 
separator will have two tokens, one on each 
side of the separator. The separator doesn’t 
count as a token. 
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saving objects 


Version IV: A Pig Serialization ftotcha 

Now you’ve seen that I/O in Java is actually pretty simple, especially if 
you stick to the most common connection/chain combinations. But 
there’s one issue you might really care about. 

Version Control is crucial! 

If you serialize an object, you must have the class in order to 
deserialize and use the object. OK, that’s obvious. But what might 
be less obvious is what happens if you change the class in the 
meantime? Yikes. Imagine trying to bring back a Dog object when 
one of its instance variables (non-transient) has changed from a 
double to a String. That violates Java’s type-safe sensibilities in a Big 
Way. But that’s not the only change that might hurt compatibility. 
Think about the following: 


Changes to a class that can hurt deserialization: 

Deleting an instance variable 

Changing the declared type of an instance variable 

Changing a non-transient instance variable to transient 

Moving a class up or down the inheritance hierarchy 

Changing a class (anywhere in the object graph) from Serializable 
to not Serializable (by removing ‘implements Serializable’ from a 
class declaration) 

Changing an instance variable to static 


Changes to a class that are usually OK: 

Adding new instance variables to the class (existing objects will 
deserialize with default values for the instance variables they didn’t 
have when they were serialized) 

Adding classes to the inheritance tree 

Removing classes from the inheritance tree 

Changing the access level of an instance variable has no affect on 
the ability of deserialization to assign a value to the variable 

Changing an instance variable from transient to non-transient 
(previously-serialized objects will simply have a default value for the 
previously-transient variables) 


① You write a Dog class 

Dog.class 


101101 ^ 

101101 

101010w w 
1010 10 0 
01010 1 
1010101 
10101010 
1001010101 


^2) Vou serialize a Dog object 
using that class 



(§) You change the Dog class 

Dog.class 


101101 ^ 

101101 

101000_ 

1010 10 0 
01010 1 
100001 1010 
0 00110101 
1 0 1 10 10 


④ You deserialize a Dog object 
using the changed class 



101101 ^ 

101101 

101000_ 

1010 10 0 


Object 


Mt^SXOTk 



01010 1 
100001 1010 
0 00110101 
1 0 1 10 10 


Dog.class 


6 \ass 此一 


\S 


^ 5 ) Serailization fails!! 

The JVM says, ''you can’t 
teach an old Dog new code”. 
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serialization and file I/O 


Using the scrialVcrsiowUlP 

Each time an object is serialized, the object (including 
every object in its graph) is ‘stamped’ with a version 
ID number for the object’s class. The ID is called 
the serialVersionUID, and it’s computed based on 
information about the class structure. As an object is 
being deserialized, if the class has changed since the 
object was serialized, the class could have a different 
serialVersionUID, and deserialization will fail! But you 
can control this. 

If you think there is ANY possibility that 
your class might evolve, put a serial version 
ID in your class. 

When Java tries to deserialize an object, it compares 
the serialized object’s serialVersionUID with that of the 
class the JVM is using for deserializing the object. For 
example, if a Dog instance was serialized with an ID of, 
say 23 (in reality a serialVersionUID is much longer), 
when the JVM deserializes the Dog object it will first 
compare the Dog object serialVersionUID with the 
Dog class serialVersionUID. If the two numbers don’t 
match, the JVM assumes the class is not compatible 
with the previously-serialized object, and you’ll get an 
exception during deserialization. 

So, the solution is to put a serialVersionUID 
in your class, and then as the class evolves, the 
serialVersionUID will remain the same and the JVM 
will say, “OK, cool, the class is compatible with this 
serialized object.” even though the class has actually 
changed. 

This works only if you’re careful with your class 
changes! In other words, you are taking responsibility 
for any issues that come up when an older object is 
brought back to life with a newer class. 

To get a serialVersionUID for a class, use the serialver 
tool that ships with your Java development kit. 


File Edit Window Help serialKiller 


% serialver Dog 

Dog : static final long 
serialVersionUID = - 
5849794470654667210L; 


When you think your class 
might evolve after someone has 
serialized objects from it... 

① Use the serialver command-line tool 
to get the version ID for your class 


File Edit Window Help serialKiller 


% serialver Dog 

Dog : static final long 
serialVersionUID = - 
5849794470654667210L; 


( 5 ) Paste the output into your class 
public class Dog { 


static final long serialVersionUID = 

-6849794470754667710L; 


private String name; 
private int size; 

// method code here 


( 5 ) Be sure that when you make changes to 
the class, you take responsibility in your 
code for the consequences of the changes 
you made to the class! For example, be 
sure that your new Dog class can deal with 
an old Dog being deserialized with default 
values for instance variables added to the 
class after the Dog was serialized. 
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Code Kitchen 


r 






Code Kitcken 




e o o 


Cyber BeatBox 


Bass Drum @ S □ □ □ Of 


Open H 卜 Hat 

Acoustic Snare □ □ □ 

Crash Cymbal 匚 = 5? g 二 ==:= 二二 □ □ □ 口 □ 


Start 


C 5t °p 


Tempo Up 

jr 



Tempo Down 


Hand Clap 
High Tom 
Hi Bongo 
Maracas 
Whtstle 
Low Conga 
Cowbell 
Vi braslap 


serfaltzelt 

■■ - » -- ■ . - • -^ . - - =- ' . - " . - ■ - - ■ - • -- " " - 1 | • - - - - -- - -- 


^ restore 

nrni~i rn rn rn i~ 11 ~i n n rn n n n rn rn 

L_i L_J L_i L_E L_J L_J l—J L_J L—J i_J L—Ji 

n n n n n n n 臧 n n n n n n n n 

L—-i L_-l L-P-l L_-> L_-> L_-i L^i L_-> 

n n n n n n n n n n n n n n n n 

= — =^ — = ^ — ^ = — = ^ — = ^ — ^ = — ^ = — = = — = ^ — = = — ^ — == —— =^—^ —— —^ 

□ □n□□□□n□□□□□□n n 

U-^ I——I L_j L^-pJ L—i U_J I——I L-bJ I——i l^J L——j 

□ □ g □□□□□□ ^ ^ = 

m 门厂 1 厂 1 厂 1 门 n n n 门 M 厂 > n 门 n n 

« I I _ I 1 1 I _ I l^_pj I I L^_J I I 1 1 I _ I I_—I I _ I L^_J l _ i L^bpJ I I 

Low-mid Tom □ □ □□□□:□□□□ Q □ □ □ 麵 □ 

High Agog 。 □ 0 ■] □ □ 0 □ □ □ 匚 _=: 函 □ 匚 □ 

Open Hi Conga 口 □□□□□□□ □□□□□□□□ 





scr\a\^^ » 


U saved- 




Let’s make tke BeatBox save and 
restore our favorite pattern 
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serialization and file I/O 


Saving a PcatPox pattern 

Remember, in the BeatBox, a drum pattern is nothing more than a bunch of 
checkboxes. When it’s time to play the sequence, the code walks through the 
checkboxes to figure out which drums sounds are playing at each of the 16 
beats. So to save a pattern, all we need to do is save the state of the checkboxes. 

We can make a simple boolean array, holding the state of each of the 256 
checkboxes. An array object is serializable as long as the things in the array are 
serializable, so we’ll have no trouble saving an array of booleans. 

To load a pattern back in, we read the single boolean array object (deserialize 
it), and restore the checkboxes. Most of the code you’ve already seen, in the 
Code Kitchen where we built the BeatBox GUI, so in this chapter, we look at 
only the save and restore code. 

This CodeKitchen gets us ready for the next chapter, where instead of writing 
the pattern to 3. file, we send it over the network to the server. And instead of 
loading a pattern in from a file，we get patterns from the server, each time a 
participant sends one to the server. 


Serializing a pattern 


TWis IS av\ c\ass ms’dc 
i\st ^ode- 


public class MySendListener implements ActionListener 
public void actionPerformed(ActionEvent a) { 




boolean[] checkboxState = new boolean[256]; ^ — - 

for (int i = 0; i < 256; i++) { 

JCheckBox check = (JCheckBox) checkboxList.get(i); 
if (check.isSelected()) { 

checkboxState[i] = true; 


try { 

FileOutputStream file Stream = new FileOutputStream (new File (''Checkbox • ser")); 
ObjectOutputStream os = new ObjectOutputStream (filestream); 
os.writeObject(checkboxState); 丁 

} catch (Exception ex) { ^ ^ Jusi 

ex. printstackTrace () ; ohc boolcdh 

} // close method 
} // close inner class 


5lr\r5y/ 
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deserializing the pattern 


Rcstormg a PcatPox pattern 

This is pretty much the save in reverse... read the boolean array and use it 
to restore the state of the GUI checkboxes. It all happens when the user hits 
the “restore” 'button. 


Restoring a pattern 

TW»S，S a ⑽七 ^ dlass 

ms.dc BcatBo% dlass. 

public class MyReadlnListener implements ActionListener { 


public void actionPerformed(ActionEvent a) { 
boolean[] checkboxState = null; 
try { 

FilelnputStream file In = new FilelnputStream (new File (''Checkbox, ser^)); 
ObjectlnputStream is = new ObjectlnputStream(fileln); 

checkboxState = (boolean [ ]) is. readObject () ; ^ — Read obje 乙七 m t t 

「 vaY) 

boolean 


catch(Exception ex) {ex.printstackTrace();} 


l i ^ 6 as*t *>*b ba^k -to a 

VC-tuVV'S a vc-Vcvc^c 


for (int i = 0; i < 256; i++) { 
JCheckBox check = (JCheckBox) 
if (checkboxState[i]) { 

check.setSelected(true); 

} else { 

check.setSelected(false); 


checkboxList.get(i); 


Wow the siai c o( ^ ^ 


sequencer.stop(); 
buildTrackAndStart() 

} // close method 
} // close inner class 


(s/oy/ stof y/^atever »s 
dr.a rebuild 

state ^ctkbo^cs rn MayL.st. 


pt^arpen your pencil 

This version 


has a huge limitation! When you hit the "serializelt" button, it 
serializes automatically, to a file named "Checkbox.ser” (which gets created if it 
doesn’t exist). But each time you save, you overwrite the previously-saved file. 


Improve the save and restore feature, by incorporating a JFileChooser so that 
you can name and save as many different patterns as you like, and load/restore 
from any of your previously-saved pattern files. 
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e^^rpen your pencil 


Can they be saved? 

Which of these do you think are, or should be, 
serializable? If not, why not? Not meaningful? 
Security risk? Only works for the current 
execution of the JVM? Make your best guess, 
without looking it up in the API. 


Object type 

Serializable? 

Object 

Yes / 

No 

String 

Yes / 

No 

File 

Yes / 

No 

Date 

Yes / 

No 

OutputStream 

Yes / 

No 

JFrame 

Yes / 

No 

Integer 

Yes / 

No 

System 

Yes / 

No 


If not, why not? 


What’s LegalP 

Circle the code fragments 
that would compile (assuming 
they’re within a legal class). 


KEEP 

RIGHT 


FileReader fileReader = new FileReader(); 

BufferedReader reader = new BufferedReader(fileReader); 


FileOutputStream f = new FileOutputStream (new File (''Foo. ser A, )); 
ObjectOutputStream os = new ObjectOutputStream(f); 


BufferedReader reader = new BufferedReader(new FileReader(file)); 
String line = null; 

while ((line = reader.readLine()) != null) { 
makeCard(line); 


ObjectlnputStream is = new ObjectInputStream(new FileOutputStream(''Game.ser")); 
GameCharacter oneAgain = (GameCharacter) is.readObject(); 
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exercise: True or False 


This chapter explored the wonerful world of 
Java I/O. Your job is to decide whether each 
of the following l/O-related statements is 
true or false. 

ok Fawe ^ 

1. Serialization is appropriate when saving data for non-Java programs to use. 

2. Object state can be saved only by using serialization. 

3. ObjectOutputStream is a class used to save serialized objects. 

4. Chain streams can be used on their own or with connection streams. 

5. A single call to writeObject() can cause many objects to be saved. 

6. All classes are serializable by default. 

7. The transient modifier allows you to make instance variables serializable. 

8. If a superclass is not serializable then the subclass can’t be serializable. 

9. When objects are deserialized, they are read back in last-in, first out sequence. 

10. When an object is deserialized, its constructor does not run. 

11. Both serialization and saving to a text file can throw exceptions. 

12. BufferedWriters can be chained to FileWriters. 

13. File objects represent files, but not directories. 

14. You can’t force a buffer to send its data before it’s full. 

15. Both file readers and file writers can be buffered. 

16. The String split() method includes separators as tokens in the result array. 

17. Any change to a class breaks previously serialized objects of that class. 
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， ^^ Code Magnets 

* This one’s tricky, R) we proi 


serialization and file I/O 


File Edit Window Help Torture 


java DungeonTest 


promoted it from an Exercise to full Puzzle status. 
Reconstruct the code snippets to make a working Java program that 
produces the output listed below? (You might not need all of the magnets, 
and you may reuse a magnet more than once.) 



F i1eOutputStream 


fos = new 


FileOutpu 


tstream("dg.ser )’ 


e.printStackTrace(); 


ObjectlnputStream ois = new 

Object • 工 nputStreani(fis); 


int getX() { 
return x; 




System.out.println(d•getX()+d.getY()+d.getZ()); 


- - ; -- 

FilelnputStream fis = new 

blic int x = 3; 

FileInputStream("dg •ser"); 

ansient long y = 4; 

- - 

ivate short z = 5; 


long getY() 
return y; 


^ lass Dun geonTest { 


import java.io.*. 


fos .writeObject(d); 


} catch (Exception e) 


d = (DungeonGame) ois.readObject(); 


Obj ectOutputStream oos = new 
ObjectOutputStream(fos); 


oos 


.writeObject(d); 


DungeonGame d = new DungeonGame (JK 
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exercise solutions 


秦 • ， 

Exercise Solutions 

1. Serialization is appropriate when saving data for non-Java programs to use. False 

2. Object state can be saved only by using serialization. False 

3. ObjectOutputStream is a class used to save serialized objects. True 

4. Chain streams can be usedon their own or with connection streams. False 

5. A single call to writeObject() can cause many objects to be saved. True 

6. All classes are serializable by default. False 

7. The transient modifier allows you to make instance variables serializable. False 

8. If a superclass is not serializable then the subclass can’t be serializable. False 

9. When objects are deserialized they are read back in last-in, first out sequence. False 

10. When an object is deserialized, its constructor does not run. True 

11. Both serialization and saving to a text file can throw exceptions. True 

12. BufferedWriters can be chained to FileWriters. True 

13. File objects represent files, but not directories. False 

14. You can’t force a buffer to send its data before it’s full. False 

15. Both file readers and file writers can optionally be buffered. True 

16. The String split() method includes separators as tokens in the result array. False 

17. Any change to a class breaks previously serialized objects of that class. False 
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serialization and file I/O 



import java.io.*; 


class DungeonGame implements Serializable { 
public int x = 3; 
transient long y = 4; 
private short z = 5; 
int getX() { 
return x; 

} 

long getY() { 
return y; 

} 

short getZ() { 
return z; 

} 


File Edit Window Help Escape 


java DungeonTest 


class DungeonTest { 

public static void main(String [] args) { 

DungeonGame d = new DungeonGame(); 

System.out.println(d.getX() + d.getY() + d.getZ()); 
try { 

FileOutputStream fos = new FileOutputStream("dg•ser"); 
ObjectOutputStream oos = new ObjectOutputStream(fos); 
oos.writeObject(d); 
oos.close(); 

FilelnputStream fis = new FileInputStream("dg•ser"); 

ObjectlnputStream ois = new ObjectInputStream(fis); 
d = (DungeonGame) ois.readObject(); 
ois.close(); 

} catch (Exception e) { 
e.printStackTrace(); 


System.out.println(d.getX() + d.getY() + d.getZ()); 
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15 networking and threads 


Make a Connection 



Connect with the outside world. Your Java program can reach out and touch a 
program on another machine. It’s easy. All the low-level networking details are taken care of by 
classes in thejava.net library. One of Java’s big benefits is that sending and receiving data over 
a network is just I/O with a slightly different connection stream at the end of the chain. If you’ve 
got a Buffered Reader, you can read. And the BufferedReader could care less if the data came 
out of a file or flew down an ethernet cable. In this chapter we’ll connect to the outside world 
with sockets. We’ll make d/e/if sockets. We’ll make server sockets. We'll make clients and servers. 
And we’ll make them talk to each other. Before the chapter’s done, you’ll have a fully-functional, 
multithreaded chat client. Did we just say multithreaded? Yes, now you will learn the secret of 
how to talk to Bob while simultaneously listening to Suzy. 


this is a new chapter 471 


beat box chat 


Real-time Peat Pox Chat 




BeatSox 

? 二 二 :: PZ:: 
二二 

]OOQqqqp] 

-^OOqq nnn 
] °Oooonn 
'oaaaonn 


/ Eass Drum ^ ~ 

I c/ osedHi-Hat 二二 

/ 0 卿 … -Hat 5 二 

I Aco ⑽ ic Snare 5 5 
I Crash Cymbaf 二二 
/ Hand Dap 
I High TT 0rn 
Hi Bo ngo 二 "；，: 

I 岣 rac 舡 -V? ' lK 

55 - 

I Low Conga 二—二 
Cowbef ， ，； 二 r ； 

Vibr as , ap 

Low ~mid Tom ' 三二，二 

Hi 9h Agogo 二―二 
Open Hi Conga ~~ ~~ ■— 


一一 巧〜云 5 

J °Oaaannn 

pooaoo^ 

J ^oaooaS 

'OQOOnnnn 


nk y，good fo 


I 


S: n l£ h s e 






street? 

, 二义 t 二 

1 二二， 

1 mo^ ^ here rig 

1 oarkStar 

1 Muffi 
1 Who said that? 




Yattcv^ 


You’re working on a computer game. You and your team 
are doing the sound design for each part of the game. 
Using a ‘chat’ version of the Beat Box, your team can 
collaborate — you can send a beat pattern alone* with 
your chat message, and everybody in the Beat 
gets it. So you don’t just get to read the other 
participants’ messages, you get to load and 
play a beat pattern simply by clicking the 
message in the incoming messages area. 

In this chapter we’re going to learn what it 
takes to make a chat client like this. We’re 
even going to learn a little about making a 
chat server. We’ll save the full Beat Box Chat 
for the Code Kitchen, but in this chapter you 
will write a Ludicrously Simple Chat Client an 
Very Simple Chat Server that send and receiv< 
text messages. 


mcssay 

loads tV^c 卜伽於減 — 七 


格 : r ㈣ 

stimulating dhat ' 
^ohvcvsatiohs. Evcvy 
is s^i i 0 Jii 
P^tidipah-ts. 


Sc^d youv- message io 七 he scv-vcv- 
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Chat Program Overview 

The Client has to \now 
about Ae Server. 

The Server has to tnow 
about ALL Ae Clients. 


How it Works: 



Client A 


Why am I 
here? Don’t 
expect ME to 
answer that. 


there are currently 
3 participants in 
this chat session ： 
Client A, Client B 
and Client C 

__ 一 

Server 


Client B 


Client C 


❶ Client connects to the server 


© The server makes a 

connection and adds the client 
to the list of participants 

❺ Another client connects 


^ Client A sends a message to 
the chat service 


\ _! I_ Scv-vc\r, fd like *to 

' 1 1 *to sev-vide 

Client A 



Server 



0 ^, youVc m- 


Client A 



Server 



Client B 


Scv-vc\r, fd like *to 匕 owed 七 
*to -the scv-vi^c 

- 0^, youVc m- 


Participants: 

1. Client A 

2. Client B 

- — 

Server 


0 
Client A 


'Who -took -the lava lamp 
-fvom my dovrn voorw? 



Server 


❺ The server distributes the 
message to ALL participants 
(including the original sender) 



Client A 



WKo -took i\\t lava lamp 

-fyom mV do\rm VOOm? 



Server 


Client B 
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socket connections 


CoHHectmg, Sendmg. and Receiving 

The three things we have to learn to get the client working are : 

1) How to establish the initial connection between the client and server 

2) How to send messages to the server 

3) How to receive messages from the server 

There’s a lot of low-level stuff that has to happen for these things to work. But we’re 
lucky, because the Java API networking package (java.net) makes it a piece of cake 
for programmers. You’ll see a lot more GUI code than networking and I/O code. 

And that’s not all. 

Lurking within the simple chat client is a problem we haven’t faced so far in this 
book: doing two things at the same time. Establishing a connection is a one-time 
operation (that either works or fails). But after that, a chat participant wants to 
send outgoing messages and simultaneously receive incoming messages from the other 
participants (via the server). Hmmmm." that one’s going to take a little thought, but 
we’ll get there in just a few pages. 


O Connect 

Client connects to the server by 
establishing a Socket connection. 



/\/|ake a sotkc*t 七 ’ior> 七。 

ai Yori ^000 


Client A 


O Send 

Client sends a message to the server 



y/vi 七 


Client A 


❺ Receive 

Client gets a message from the server 



S 七， m3 s 二 v-cadcv- v-cadL*mcO 


chat server at 
196.164.1.103, 
port 5000 

Server 


Server 
machine at 
196.164.1J03 

Server 



Client A 


Server 
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Make a network Socket connection 


networking and threads 


To connect to another machine, we need a Socket connection. 
A Socket (java.net.Socket class) is an object that represents 
a network connection between two machines. What’s a 
connection? A relationship between two machines, where two 
pieces of software know about each other. Most importantly, 
those two pieces of software know how to communicate with 
each other. In other words, how to send bits to each other. 

We don’t care about the low-level details, thankfully, because 
they’re handled at a much lower place in the ‘networking 
stack’. If you don’t know what the ‘networking stack’ is, don’t 
worry about it. It’s just a way of looking at the layers that 
information (bits) must travel through to get from a Java 
program running in a JVM on some OS, to physical hardware 
(ethernet cables, for example), and back again on some other 
machine. Somebody has to take care of all the dirty details. 

But not you. That somebody is a combination of OS-specific 
software and the Java networking API. The part that you have 
to worry about is high-level — make that very high-level — and 
shockingly simple. Ready? 


To make a Socket 
connection, you need 
to \now Aings 

about ihe server: 
it is, and A\tecli port 
it’s inmning on. 

In other words, 

IP address and TCP 
port number. 




Socket chatSocket = new Socket 「 196 •164.1.103〃 A 5000); 



Client Server 


A Socket connection means Ae two maclitnes have 
information about each odier, including networt 
location (IP address) and TCP port. 
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well-known ports 


A TCP port is just a number: 

A 16-bit number that identifies 
a specific program ow the server. 


Your internet web (HTTP) server runs on port 80. That’s a 
standard. If you’ve got a Telnet server, its running on port 
23. FTP? 20. POP3 mail server? 110. SMTP? 25. The Time 
server sits at 37. Think of port numbers as unique identifiers. 
They represent a logical connection to a particular piece of 
software running on the server. That’s it. You can’t spin your 
hardware box around and find a TCP port. For one thing, 
you have 65536 of them on a server (0 - 65535). So they 
obviously don’t represent a place to plug in physical devices. 
They’re just a number representing an application. 

Without port numbers, the server would have no way of 
knowing which application a client wanted to connect to. 
And since each application might have its own unique 
protocol, think of the trouble you’d have without these 
identifiers. What if your web browser, for example, landed 
at the POP3 mail server instead of the HTTP server? The 
mail server won’t know how to parse an HTTP request! And 
even if it did, the POP3 server doesn’t know anything about 
servicing the HTTP request. 

When you write a server program, you’ll include code that 
tells the program which port number you want it to run on 
(you’ll see how to do this in Java a little later in this chapter). 
In the Chat program we’re writing in this chapter, we picked 
5000. Just because we wanted to. And because it met the 
criteria that it be a number between 1024 and 65535. Why 
1024? Because 0 through 1023 are reserved for the well- 
known services like the ones we just talked about. 

And if you’re writing services (server programs) to run on 
a company network, you should check with the sys-admins 
to find out which ports are already taken. Your sys-admins 
might tell you, for example, that you can’t use any port 
number below, say, 3000. In any case, if you value your limbs, 
you won’t assign port numbers with abandon. Unless it’s 
your home network. In which case you just have to check with 
your kids. 


Well-known TCP port numbers 
for common server applications 



TcUe 七 




rr? 


TirwC 


^TTp 


wttps 


P0PZ 


A scv-vcv- 乙 a 的 have up *to 厶弓弓 3 厶 
scv-vcv apps 
pev- po\rt- 


The TCP port 
numbers from 0 to 1023 
are reserved fop well - 
tnown services. Don’t 
use ihem fop your own 
server programs 

The chat Server we’re 
writing uses port 
5000 . Me just picked a 

number between 1024 
and 65535. 


*Well, you might be able to use one of 
these, but the sys-admin where you 
work will probably kill you. 
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^^tfcereiqrejiP 

Dumb Questions 

How do you know the port 
number of the server program you 
want to talk to? 

A. 

Jr \* That depends on whether the 
program is one of the well-known 
services. If you’re trying to connect 
to a well-known service, like the ones 
on the opposite page (HTTP, SMTP, 
FTP, etc.) you can look these upon 
the internet (Google"Well-Known 
TCP Port"). Or ask your friendly 
neighborhood sys-admin. 

But if the program isn’t one of the 
well-known services, you need to 
find out from whoever is deploying 
the service. Ask him. Or her.Typically, 
if someone writes a network service 
and wants others to write clients for 
it, they’ll publish the IP address, port 
number, and protocol for the service. 
For example, if you want to write a 
client for a GO game server, you can 
visit one of the GO server sites and 
find information about how to write a 
client for that particular server. 


Can there ever be more than 
one program running on a single 
port? In other words, can two 
applications on the same server have 
the same port number? 


A ： 


No! If you try to bind a program 
to a port that is already in use, you’ll 
get a BindException.To bind a program 
to a port just means starting up a 
server application and telling it to run 
on a particular port. Again,you’ll learn 
more about this when we get to the 
server part of this chapter. 


IP dddvess is ihe mall 


IP address is like specifying a 
particular shopping mall, say, 
'Flatirons Marketplace” 





Port number is like naming 
a specific store, say, 

、、 Bob’s CD Shop" 




Brain Barbell 


OK, you got a Socket connection.The client and the 
server know the IP address and TCP port number for 
each other. Now what? How do you communicate 
over that connection? In other words, how do you 
move bits from one to the other? Imagine the kinds of 
messages your chat client needs to send and receive. 


Hon. do Uo 
actually ^ 

ot^cv-? 






Client 


Chat server 
program 

Server 
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reading from a socket 


To read data from a Socket use a 
PufferedReader 

To communicate over a Socket connection, you use streams. 
Regular old I/O streams, just like we used in the last chapter. One 
of the coolest features in Java is that most of your I/O work won’t 
care what your high-level chain stream is actually connected to. In 
other words, you can use a BufferedReader just like you did when 
you were writing to a file, the difference is that the underlying 
connection stream is connected to a Socket rather than a File! 


•mpu 七 ou*tpu 七 s*t\rcar»\s 

*to and -f\rom xhc Socket 

乙 ojrmc 匕 "bo 灼 s 



o 


Make a Socket connection to the server 








❺ 


Socket chatSocket = new Socket (''127 • 0 • 0 • 1 〃， 5000); 

Moke on InputStreamReader chained to 卞 he Sockets 
low-level (connection) input stream 

InputStreamReader stream = new InputStreamReader(chatSocket.getInputStream()) 

/ 

_ tH h di y m ， u 。 


栋 c stv-cam). 


o Make a BufferedReader and read! 


CWm ^ to lo^; 


⑯ ㈣: 口一 “ 


i\st Socket) 


BufferedReader reader = new BufferedReader(stream); 
String message = reader.readLine(); 


B 


Client 


•oh 


buffered characters 


converted to characters bytes from server 


buffered 
characters 

BufferedReader 


chained to 



chained to 



InputStreamReader 


Socket’s input stream 
(we don't need to know 
the actual class) 




A 

Data on the I 


server 1 


Server 
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To write data to a Socket use a 
PrmtWritcr 


We didn’t use PrintWriter in the last chapter, we used BufferedWriter. We have 
a choice here, but when you’re writing one String at a time, PrintWriter is the 
standard choice. And you’ll recognize the two key methods in PrintWriter, 
print() and println()! Just like good ol’ System.out. 


o 


Moke a Socket connection to the server 


, 丄，本心 same as vt 如 as , 


Socket chatSocket = new Socket (''127 • 0 • 0 • 1 〃， 5000); 


o Moke a PrintWriter chained to the Sockets low-level 
(connection) output stream 


PrintWriter writer 


new PrintWriter(chatSocket.getOutputStream()); 

/ 








Socket 


鷀驗 ㈣ , 


❺ Write (print) something 


Yv.w'bl〆）adds 


writer .println (''message to send"); < — , 
writer.print (''another message") ; ^ diocs^t add 


a y>c>w Vmc at 

VmC- 


cd oJf 奶 ds. 


souvdc 


characters 


bytes to server 



to know the actual class) 




Chat server 
program 



Server 
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writing a client 


The PailyAdviceClient 

Before we start building the Chat app, 
let’s start with something a little smaller. 
The Advice Guy is a server program that 
offers up practical, inspirational tips 
to get you through those long days of 
coding. 

We’re building a client for The Advice 
Guy program, which pulls a message 
from the server each time it connects. 

What are you waiting for? Who knows 
what opportunities you’ve missed 
without this app. 


o Connect 



The Advice Guy 


Client connects to the server and gets an 
input stream from it 

/\/|ake a sodkc*t dovm 杜七 ioir> 七。 
l a*t pov*t 午 2 • 午 2* 

sodke 七 .ytl 叶 iA*tS*bream() - 

Client 



advice server 
at 190.165.1.103, 
port 4242 



Server 


O Read 

Client reads a message from the server 



adv'itc =■ v-cadcv-v-cadL*mcO 


advice server 

composes 

advice and 

sends it 
_ 1 

Server 
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PailyAdviceClient code 

This program makes a Socket, makes a BufferedReader (with the 
help of other streams), and reads a single line from the server 
application (whatever is running at port 4242). 

import java.io.*; 
import java.net.*; 

public class DailyAdviceClient { 

public void go() { 

try { ^ — a 〜叫 ^ 

Socket s = new Socket (''127 • 0 • 0 • 1 〃， 4242); 






6 \ass So6kct ^ java. 




InputstreamReader streamReader = new InputstreamReader(s.getlnputStream()); 

BufferedReader reader = new BufferedReader (streamReader) ; ^ ^u-f-fcvcdRcddcv "to 

|y\fu*tS*tv"caw>Rcadcv- *to 
mP'A't s*tv-caw> *fv-ow> 
Socket 


String advice = reader.readLine(); 
System, out .pr in tin (''Today you should : 



+ advice) 


reader. close () ; ^~-^',s closes ^LL s-tvcSw'S 


catch(IOException ex) 
ex.printstackTrace() 


is £ XActly 

u 】 ih ” 

i c 〜 ⑽的： WhC " C 


public static void main(String[] args) { 

DailyAdviceClient client = new DailyAdviceClient() 
client.go(); 
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Iharpen your pencil 


Fill in the blanks: 


What two pieces of information does the client need in order to make a 
Socket connection with a server? 


Which TCP port numbers are reserved for'well-known services’like HTTP and FTP? 


TRUE or FALSE: The range of valid TCP port numbers can be represented 
by a short primitive? 
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Writing a simple server 

So what’s it take to write a server application? Just a 
couple of Sockets. Yes, a couple as in two. A ServerSocket, 
which waits for client requests (when a client makes a 
new Socket。）and a plain old Socket socket to use for 
communication with the client. 


How it Works: 


o Server application makes a Server Socket, on a specific port 

ServerSocket serverSock = new ServerSocket(4242); 


This starts the server application listening 
for client requests coming in for port 4242. 







Client makes a Socket connection to the server application 


Socket sock = new Socket (''190 • 165 • 1 • 103 〃， 

Client knows the IP address and port number 
(published or given to him by whomever 
configures the server app to be on that port) 



4242); 






Server makes a new Socket to communicate with this client 

Socket sock = serverSock.accept(); 

The accept。method blocks (just sits there) while 
\Ys waiting for a client Socket connection. When a 
client finally tries to connect, the method returns 
a plain old Socket (on a different port) that knows 
how to communicate with the client (i.e., knows the 
dienfs IP address and port number). The Socket is on 
a different port than the ServerSocket, so that the 
ServerSocket can go back to waiting for other clients. 



^od(ci 




㈣ 饮 
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writing a server 

PailyAdvicGScrvcr code 

This program makes a ServerSocket and waits for client requests. When it gets 
a client request (i.e. client said new Socket() for this application), the server 
makes a new Socket connection to that client. The server makes a PrintWriter 
(using the Socket’s output stream) and sends a message to the client. 


import java.io.*; 
import java.net.*; 



public class DailyAdviceServer { 


da 々 adv 化 “⑽ es W 铷 s 3 叫 


⑽讀 d -娜， 

toAt cd 呼 •= 

a St—!) 


String[] adviceList = {''Take 
make you look fat.〃，''One word: 


smaller bites〃，''Go for the tight jeans. No they do NOT 
inappropriate", ''Just for today, be honest. Tell your 


boss what you *really* think 〃， ''You might want to rethink that haircut.〃}; 


public void go() { 

try { 

ServerSocket serverSock = new ServerSocket(4242); 




iv\*b 。 a fcvwawt l°°?> 


Oh 
亡 ode 


while(true) { 


㈣ ：忪 


Socket sock = serverSock.accept(); 


method blocks (\us*t sits *thc\rc) uirrtil a 

\rc<\ucs*t domes \y\, the 灼 -the method \rc*tu\r 灼 s a 

/x . Sodkc*t (0 灼 some d 竹 o 灼 yrwous poirt) -Pov domry\U^idd*tm^ 


y/i 七 h 七 he d’wt 


PrintWriter writer = new PrintWriter(sock.getOutputStream()); 
String advice = getAdvice() - ^ 

writer.println(advice); 
writer.close(); 

System.out.println(advice); 




catch(IOException ex) 
ex.printStackTrace(); 


} // close go 


private String getAdvice() { 

int random = (int) (Math.random() * adviceList.length); 
return adviceList[random]; 


public static void main(String[] args) { 

DailyAdviceServer server = new DailyAdviceServer(); 
server.go(); 
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How does the server know howto 
communicate with the client? 

The client knows the IP address and port 
number of the server, but how is the server 
able to make a Socket connection with the 
client (and make input and output streams)? 

Think about how / when / where the server 
gets knowledge about the client. 



The advice server code on the opposite 
page has a VERY serious limitation — it looks 
like it can handle only one client at a time! 

A- 

厂 Y-Yes, that’s right. It can’t accept a request 
from a client until it has finished with the 
current client and started the next iteration of 
the infinite loop (where it sits at the acceptO 
call until a request comes in, at which time it 
makes a Socket with the new client and starts 
the process over again). 

Let me rephrase the problem: how can 
you make a server that can handle multiple 
clients concurrently??? This would never 
work for a chat server, for instance. 

A. 

Ah, that's simple, really. Use separate 
threads, and give each new client Socket to a 
new thread. We’re just about to learn how to 
do that! 


_BULLET POINTS _ 

■ Client and server applications communicate over a Socket 
connection. 

■ A Socket represents a connection between two applications 
which may (or may not) be running on two different physical 
machines. 

■ A client must know the IP address (or domain name) and 
TCP port number of the server application. 

■ A TCP port is a 16-bit unsigned number assigned to a 
specific server application. TCP port numbers allow different 
clients to connect to the same machine but communicate 
with different applications running on that machine. 

■ The port numbers from 0 through 1023 are reserved for 
‘well-known services’ including HTTP, FTP, SMTP, etc. 

■ A client connects to a server by making a Server socket 
Socket s = new Socket (、、127 • 0 • 0 • 1 〃， 4200); 

■ Once connected, a client can get input and output streams 
from the socket. These are low-level ‘connection’ streams. 

sock.getInputStream(); 

■ To read text data from the server, create a BufferedReader, 
chained to an InputStreamReader, which is chained to the 
input stream from the Socket. 

■ InputStreamReader is a ‘bridge’ stream that takes in 
bytes and converts them to text (character) data. It’s used 
primarily to act as the middle chain between the high-level 
BufferedReader and the low-level Socket input stream. 

■ To write text data to the server, create a PrintWriter chained 
directly to the Socket’s output stream. Call the print() or 
println() methods to send Strings to the server. 

■ Servers use a ServerSocket that waits for client requests on 
a particular port number. 

■ When a ServerSocket gets a request, it ‘accepts’ the request 
by making a Socket connection with the client. 
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a simple chat client 

Writing a Chat Client 

We’ll write the Chat client application in two stages. First we’ll 
make a send-only version that sends messages to the server but 
doesn’t get to read any of the messages from other participants 
(an exciting and mysterious twist to the whole chat room 
concept). 

Then we’ll go for the full chat monty and make one that both 
sends and receives chat messages. 

Version One: send-only 



丁 ye a 


Code outline 

public class SimpleChatClientA { 

JTextField outgoing; 

PrintWriter writer; 

Socket sock; 

public void go() { 

// make gui and register a listener with the send button 
// call the setUpNetworking() method 


private void setUpNetworking() { 

// make a Socket, then make a PrintWriter 

// assign the PrintWriter to writer instance variable 


public class SendButtonListener implements ActionListener { 
public void actionPerformed(ActionEvent ev) { 

// get the text from the text field and 

// send it to the server using the writer (a PrintWriter) 

} 

} // close SendButtonListener inner class 

} // close outer class 
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import java.io.*; 
import java.net.*; 
import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 


兹娜溆 。)’ 


public class SimpleChatClientA { 

JTextField outgoing; 
PrintWriter writer; 

Socket sock; 


public void go() { 

JFrame frame = new JFrame (''Ludicrously Simple Chat Client"); 
JPanel mainPanel = new JPanel(); 
outgoing = new JTextField(20); 

JButton sendButton = new JButton (''Send"); 
sendButton.addActionListener(new SendButtonListener()); 
mainPanel.add(outgoing); 
mainPanel.add(sendButton); 


心 


frame. getContentPane () . add (BorderLayout. CENTER, mainPanel); 
setUpNetworking(); 
frame.setSize(400,500); 


frame.setVisible(true); 

} // close go 

private void setUpNetworking() 
try { 




u S i h g Ualhosi 
l 0[A . ^ ihc die 


So 


oh ohc ^hihe 


sock = new Socket (''127 • 0 • 0 • 1 〃， 5000); 

writer = new PrintWriter(sock.getOutputStream()); 

System, out .println (''networking established"); 


} catch(IOException ex) { 


ex.printStackTrace(); 


TW.s »s 诎价 w Socket 

and 仏 c (its tailed 

dtopUY— a ?? 咖 I) 


} // close setUpNetworking 


public class SendButtonListener implements ActionListener { 
public void actionPerformed(ActionEvent ev) 
try { 

writer.println(outgoing.getText()); 
writer .flush (); 


} catch(Exception ex) { 
ex.printStackTrace(); 

} 

outgoing. setText ('、">; 
outgoing.requestFocus(); 

} 

} // close SendButtonListener inner class 

public static void main(String[] args) { 
new SimpleChatClientA().go(); 

} 

// close outer class 


{ 

Now wc actually do *thc y/vitmj. 
Rcrwcrwbcv-, *thc wv*i*tc\r is shamed *bo 
七 he mpu 七 s-t\rc3m -Pvom *thc Socket ； so 
y/hc^cvc\r wc do d i 七 ^oes 

ovcv- *thc ^c*tv/o\rk to sc\rvc\r/ 


If you want to try this now, type in 
the Ready-bake chat server code 
listed at the end of this chapter . 
First, start the server in one terminal. 
Next, use another terminal to start 
this client. 
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improving the chat client 



Version Two: send 
and receive 


ou-tgoihg message 


9 

streets 

一 1 一 

Mr^Star 

MuffinMan 

U ; 二二 咖，？ 

■rtho said thflt? 


Tk Sc\rvc\r schds a message to all 
乙 li ⑶七 pavtitipahts, as sooh as £k e 
message is \rc^civcd by the sevvev-. 
I/Vhch a ^liCht schds d i-t 

do«h’t appear ih the \uo^ 
message display a\rca uh-til -the 
se\rv 饮 schds it to cvcv-yohc. 


Big Question: HOW do you get messages from the server? 

Should be easy; when you set up the networking make an input stream as well 
(probably a BufferedReader). Then read messages using readLine(). 


Bigger Question: WHEN do you get messages from the server? 

Think about that. What are the options? 

① Option One: Poll the server every 20 seconds 

Pros: Well ， it’s do-able 

Cons: How does the server know what you’ve seen and what you haven’t? The server 
would have to store the messages, rather than just doing a distribute-and-forget each time 
it gets one. And why 20 seconds? A delay like this affects usability, but as you reduce the 
delay, you risk hitting your server needlessly. Inefficient. 

(5) Option Two: Read something in from the server each time the user 
sends a message. 

Pros: Do-able, very easy 

Cons: Stupid. Why choose such an arbitrary time to check for messages? What if a user is 
a lurker and doesn’t send anything? 

(^) Option Three: Read messages as soon as they’re sent from the server 

Pros: Most efficient, best usability 

Cons: How do you do you do two things at the same time? Where would you put this code? 
You’d need a loop somewhere that was always waiting to read from the server. But where 
would that go? Once you launch the GUI, nothing happens until an event is fired by a GUI 
component. 
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In Java you really CM 
walk and chew gum at 
the sme time. 


You know by now that we’re 
going with option three. 

We want something to run continuously, 
checking for messages from the server, 
but without interrupting the user’s ability to 
interact with the GUI! So while the user is 
happily typing new messages or scrolling 
through the incoming messages, we 
want something behind the scenes to keep 
reading in new input from the server. 

That means we finally need a new thread. 
A new, separate stack 

We want everything we did in the Send- 
Only version (version one) to work the 
same way, while a new process runs along 
side that reads information from the 
server and displays it in the incoming text 
area. 

Well, not quite. Unless you have multiple 
processors on your computer, each new 
Java thread is not actually a separate 
process running on the OS. But it almost 
feels as though it is. 


Multithreading in Java 

Java has multiple threading built right 
into the fabric of the language. And it’s a 
snap to make a new thread of execution: 

Thread t = new Thread(); 
t. start (); 

That’s it. By creating a new Thread object ， 
you’ve launched a separate thread of 
execution, with its very own call stack. 

Except for one problem. 

That thread doesn’t actually do anything, 
so the thread “dies” virtually the instant 
it’s born. When a thread dies, its new 
stack disappears again. End of story. 

So we’re missing one key component — 
the thread’s job. In other words, we need 
the code that you want to have run by a 
separate thread. 

Multiple threading in Java means we 
have to look at both the thread and the job 
that’s run by the thread. And we’ll also 
have to look at the Thread class in the 
java.Iang package. (Remember, java.lang 
is the package you get imported for 
free, implicitly, and it’s where the classes 
most fundamental to the language live, 
including String and System.) 
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Java has multiple threads but only 
one Thread class 


We can talk about thread with a lower-case ‘t’ and Thread 
with a capital 4 T\ When you see thread, we’re talking 
about a separate thread of execution. In other words, 
a separate call stack. When you see Thread, think of 
the Java naming convention. What, in Java, starts with a 
capital letter? Classes and interfaces. In this case, Thread 
is a class in the java.Iang package. A Thread object 
represents a thread of execution', you’ll create an instance of 
class Thread each time you want to start up a new thread 
of execution. 




separate call stack. 

A TkPead is a Java 
class Aat represents 
a Aread. 

To mke a Aread, 
make a Tkread. 


• 9 ^ 


thread 


Thread 



main thread another thread 

started by the code 


Thread 

void join() 
void start() 

static void sleep() 


java.Iang.Thread 

class 


A thread (lower-case ‘t’）is a separate thread of execution. 
That means a separate call stack. Every Java application 
starts up a main thread — the thread that puts the 
main() method on the bottom of the stack. The JVM 
is responsible for starting the main thread (and other 
threads, as it chooses, including the garbage collection 
thread). As a programmer, you can write code to start 
other threads of your own. 


Thread (capital ‘T’）is a class that 
represents a thread of execution. 

It has methods for starting a 
thread, joining one thread with 
another, and putting a thread to 
sleep. (It has more methods; these 
are just the crucial ones we need 
to use now). 
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What does it mean to have more thaw 
one call stack? 


networking and threads 


With more than one call stack, you get the appearance of having 
multiple things happen at the same time. In reality, only a true 
multiprocessor system can actually do more than one thing at a 
time, but with Java threads, it can appear that you’re doing several 
things simultaneously. In other words, execution can move back 
and forth between stacks so rapidly that you feel as though all stacks 
are executing at the same time. Remember, Java is just a process 
running on your underlying OS. So first, Java itself has to be ‘the 
currently executing process’ on the OS. But once Java gets its 
turn to execute, exactly what does the JVM run? Which bytecodes 
execute? Whatever is on the top of the currently-running stack! 

And in 100 milliseconds, the currently executing code might switch 
to a different method on a different stack. 

One of the things a thread must do is keep track of which statement 
(of which method) is currently executing on the thread’s stack. 

It might look something like this: 

o The JVM calls the main() method. 

public static void main(String[] args) { 


active 



main thread 


o main() starts a new thread. The main 

thread is temporarily frozen while the new 
thread starts running. 


Runnable r = new MyThreadJob() 
Thread t = new Thread(r); 
t. start (); 

Dog d = new Dog(); 



i h ; us ^ 


•start() 
main() 


main thread 


咖 一 〆 气一 

o The JVM switches between the new 
thread (user thread A) and the original 
main thread, until both threads complete. 

main thread 



a r\cv/ s-tav-ts 

becomes active 



user thread A 


x.go() : 
run() I 

■ 

user thread A 
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How to launch a new thread: 


o Make a Runnable object (the thread’s job) 

Runnable threadJob = new MyRunnable(); 

Runnable is an interface you’ll learn about on the next page, 
you'll write a class that implements the Runnable interface, 
and that class is where you’ll define the work that a thread 
will perform. In other words, the method that will be run 
from the thread's new call stack. 



❺ Make a Thread object (the worker) and 
give it a Runnable (the job) 

Thread myThread = new Thread(threadJob); 

Pass the new Runnable object to the Thread constructor. 
This tells the new Thread object which method to put on 
the bottom of the new stack—the Runnable's run() method. 



❺ Start the Thread 

myThread.start(); 

Nothing happens until you call the Thread's 
start() method. That's when you go from 
having just a Thread instance to having a new 
thread of execution. When the new thread 
starts up, it takes the Runnable object's 
run() method and puts it on the bottom of 
the new thread's stack. 


run() 
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Every Thread needs a job to do. 

A method to put ow the new thread stack. 



Runnable is to a 
Thread Aat a job is to 
a wortep. A Runnable 
is Ae job a Areadis 
supposed to run. 

A Runnable holds Ae 
method ihat goes on 
Ae bottom of the new 
bread’s stack*- mm(). 


A Thread object needs a job. A job the thread will run when the 
thread is started. That job is actually the first method that goes on 
the new thread’s stack, and it must always be a method that looks 
like this: 

public void run() { 

// code that will be run by the new thread 


How does the thread know which method to put at the bottom of 
the stack? Because Runnable defines a contract. Because Runnable 
is an interface. A thread’s job can be defined in any class that 
implements the Runnable interface. The thread cares only that you 
pass the Thread constructor an object of a class that implements 
Runnable. 


aV) \, *^ ，s ^ 


When you pass a Runnable to a Thread constructor, you’re really 
just giving the Thread a way to get to a run() method. You’re giving 
the Thread its job to do. 
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Runnable interface 


To make a job for your thread, 
implement the Runnable mtcrfacc 


© 





so 彳⑽ 


public class MyRunnable implements Runnable 


public void run() { 

go(); 

} 

public void go() { 
doMore(); 

} 


Ru^ablc has ojy Ohc method to 

public void vu h O (wi 七 h ⑽ 

n \ s is — y 。， 七 — 

巧 ,s , s 叩 ㈣ 七 。、 Tk 

^ iho ^ ^ 9o« ai the boUor, 
the hew stadc 


public void doMore() { 

System, out .pr in tin (''top o r the stack") 

} 


class ThreadTester 


public static void main (String[] args) 


/ ^ wctw 


Runnable thread Job = new MyRunnable (); ^ s*t3^k- I- 


Thread myThread = new Thread(threadJob); 


i\\t Y\cyn 


o myThread .start() 



System, out .pr in tin (''back in main 〃）； 


«T d h n e%ec fT UKii, y° u 

^ally a i^ ead 1^1 1 

•i s usi a Thread 1 ihal, 

▲a ^ 


o 

I myTh^Qd.stQrtQ | 
main() 



main thread 



new thread 




Brain Barbell 


What do you think the output will be if you run the 
ThreadTester class? (we’ll find out in a few pages) 
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The three states of a new thread 




Thread t = new Thread(r); 


NEW 


■. t*" B 


RUNNABLE 


RUNNING 


t.start(); 





— 




Selected to run 



*to 

get started ” 



good *to go "’ 



supersiz^ 

*tha*t -for 

you?" 


Thread t = new Thread(r); 

A Thread instance has been 
created but not started. 

In other words, there is a 
Thread object, but no thread 
of execution. 


t. start (); 

When you start the thread, it 
moves into the runnable state. 
This means the thread is ready 
to run and just waiting for its 
Big Chance to be selected for 
execution. At this point, there is 
a new call stack for this thread. 


This is the state all threads lust 
after! To be The Chosen One. 
The Currently Running Thread. 
Only the JVM thread scheduler 
can make that decision. You 
can sometimes influence that 
decision, but you cannot force a 
thread to move from runnable 
to running. In the running 
state, a thread (and ONLY this 
thread) has an active call stack, 
and the method on the top of 
the stack is executing. 


But there’s more. Once the thread becomes 
runnable, it can move back and forth between 
runnable, running, and an additional state: 
temporarily not ruiinalile (also known as ‘blocked’). 
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thread states 


Typical runnable/running loop 


Typically, a thread moves back and 
forth between runnable and running, 
as the JVM thread scheduler selects a 
thread to run and then kicks it back 
out so another thread gets a chance. 


RUNNABLE RUNNING 



A thread can be made 
temporarily not-runnable 


The thread scheduler can move a 
running thread into a blocked state, 
for a variety of reasons. For example, 
the thread might be executing code 
to read from a Socket input stream, 
but there isn’t any data to read. The 
scheduler will move the thread out 
of the running state until something 
becomes available. Or the executing 
code might have told the thread to 
put itself to sleep (sleep ()). Or the 
thread might be waiting because it 
tried to call a method on an object, 
and that object was ‘locked’. In that 
case, the thread can’t continue until 
the object’s lock is freed by the thread 
that has it. 

All of those conditions (and more) 
cause a thread to become temporarily 
not-runnable. 


RUNNABLE 


RUNNING 




slccfmj, waitmj -fov *to -f'mish, 

waitmj -fov- *to be available oy\ -the s-tv-cam, 
y/aitmj -fo\r By\ objects lodk " 
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The Thread Scheduler 


networking and threads 


The thread scheduler makes all the decisions about 
who moves from runnable to running, and about when 
(and under what circumstances) a thread leaves the 
running state. The scheduler decides who runs, and for 
how long, and where the threads go when the scheduler 
decides to kick them out of the currently-running state. 

You can’t control the scheduler. There is no API for 
calling methods on the scheduler. Most importantly, 
there are no guarantees about scheduling! (There are a 
few a/mo5^guarantees, but even those are a little fuzzy.) 

The bottom line is this: do not base your program’s 
correctness on the scheduler working in a particular way! 

The scheduler implementations are different for 
different JVM’s，and even running the same program 
on the same machine can give you different results. 

One of the worst mistakes new Java programmers 
make is to test their multi-threaded program on a 
single machine, and assume the thread scheduler will 
always work that way, regardless of where the program 
runs. 

So what does this mean for write-once-run-anywhere? 

It means that to write platform-independent Java code, 
your multi-threaded program must work no matter how 
the thread scheduler behaves. That means that you can’t 
be dependent on, for example, the scheduler making 
sure all the threads take nice, perfectly fair and equal 
turns at the running state. Although highly unlikely 
today, your program might end up running on a JVM 
with a scheduler that says, “OK thread five, you’re up, 
and as far as I’m concerned, you can stay here until 
you’re done, when your run() method completes.” 

The secret to almost everything is sleep. That’s 
right, sleep. Putting a thread to sleep, even for a few 
milliseconds, forces the currently-running thread to 
leave the running state, thus giving another thread a 
chance to run. The thread’s sleep () method does come 
with one guarantee: a sleeping thread will n 况 become 
the currently-running thread before the the length of 
its sleep time has expired. For example, if you tell your 
thread to sleep for two seconds (2,000 milliseconds), 
that thread can never become the running thread again 
until sometime after the two seconds have passed. 


Number four, you've had 
enough time. Back to runnable. 
Number two, looks like you’re up! 


Oh, now it 


to sleep. Number five, 


place. 


like you re gonna have 
:ome take his 

Number two. 


you 


sleeping. 



The Aread 
scheduler makes all 
Ae decisions about 
a^io runs and 
doesn’t He usually 
makes Ae Areacfe take 
turns, nicely. But 
there’s no guarantee 
about Aat. He 
let one Aread run 
to its heart’s content 
A^iile Ae odier 
Areads ‘starve’. 
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An example of how unpredictable the 
scheduler can be... 


Running this code on one machine: 


Produced this output: 


public class MyRunnable implements Runnable { 

public void run() { 

go(); 

} 

public void go() { 
doMore(); 


public void doMore() { 

System, out .pr in tin (''top o r the stack"); 


class ThreadTestDrive 


public static void main (String[] args) { 


Runnable threadJob = new MyRunnable(); 
Thread myThread = new Thread(threadJob); 

myThread.start(); 

System. out. println (''back in main 〃） 





File Edit Window Help PickMe 

% j ava 

ThreadTestDrive 

back in 

main 

top o r 

the stack 

% j ava 

ThreadTestDrive 

top o’ 

the stack 

back in 

main 

% j ava 

ThreadTestDrive 

top o r 

the stack 

back in 

main 

% j ava 

ThreadTestDrive 

top o' 

the stack 

back in 

main 

% j ava 

ThreadTestDrive 

top o' 

the stack 

back in 

main 

% j ava 

ThreadTestDrive 

top o' 

the stack 

back in 

main 

% j ava 

ThreadTestDrive 

back in 

main 

top o ' 

the stack 
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How did we end up with different results? 


Sometimes it runs like this: 


main() starts the 
new thread 



main thread 


The scheduler sends 
the main thread out 
of running and back 
to runnable, so that 
the new thread can 


The scheduler lets 
the new thread 
run to completion, 
printing out “top o’ 
the stack” 


The new thread goes 
away, because its run() 
completed. The main 
thread once again 
becomes the running 
thread, and prints “back 
in main” 



main thread 


run. 


myThread. st artQ « 
m ain() j 

main thread 



new thread 


time 



And sometimes it runs like this: 


main() starts the 
new thread 


The scheduler sends 
the main thread out 
of running and back 
to runnable, so that 
the new thread can 
run. 


The scheduler lets the 
new thread run for a 
little while, not long 
enough for the run() 
method to complete. 


The scheduler 
sends the new 
thread back to 
runnable. 


The scheduler 
selects the main 
thread to be the 
running thread 
again. Main prints 
out “back in main” 



main thread 


myThread.start() • 



main thread 



new thread 


90() 

run() 

new thread 



main thread 


The new thread returns 
to the running state 
and prints out “top 0’ 
the stack”. 



new thread 


- ► 

time 
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socket connections 


r ^tJierei£ire4io 

Dumb Questions 


I’ve seen examples that don’t use a separate 
Runnable implementation, but instead just make a 
subclass of Thread and override the Thread’s run() 
method.That way, you call the Thread’s no-arg 
constructor when you make the new thread; 

Thread t = newThreadO; // no Runnable 


A ： 


Yes, that is another way of making your own 
thread, but think about it from an 00 perspective. 
What’s the purpose of subclassing? Remember that 
we’re talking about two different things here — the 
Thread and the thread’s job. From an 00 view, those 
two are very separate activities, and belong in separate 
classes.The only time you want to subclass/extend 
the Thread class, is if you are making a new and more 
specific type of Thread. In other words, if you think of 
the Thread as the worker, don’t extend the Thread class 
unless you need more specific worker behaviors. But if 
all you need is a new job to be run by a Thread/worker, 
then implement Runnable in a separatejob-specific 
(not wor/cer-specific) class. 

This is a design issue and not a performance or 
language issue. It’s perfectly legal to subclass Thread 
and override the run() method, but it’s rarely a good 
idea. 

Can you reuse a Thread object? Can you give it 
a new job to do and then restart it by calling start() 
again? 


A ： 


No. Once a thread’s run() method has completed, 
the thread can never be restarted. In fact, at that 
point the thread moves into a state we haven’t talked 
about — dead. In the dead state, the thread has 
finished its run() method and can never be restarted. 
The Thread object might still be on the heap, as a 
living object that you can call other methods on (if 
appropriate), but the Thread object has permanently 
lost its 'threadness’. In other words, there is no longer a 
separate call stack, and the Thread object is no longer 
a thread. It’s just an object, at that point, like all other 
objects. 

But, there are design patterns for making a pool of 
threads that you can keep using to perform different 
jobs. But you don’t do it by restartingO a dead thread. 


BULLET POINT 



■ A thread with a lower-case T is a separate thread of 
execution in Java. 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


Every thread in Java has its own call stack. 

A Thread with a capital T is the java.lang.Thread 
class. A Thread object represents a thread of 
execution. 

A Thread needs a job to do. A Thread’s job is an 
instance of something that implements the Runnable 
interface. 

The Runnable interface has just a single method, run(). 
This is the method that goes on the bottom of the new 
call stack. In other words, it is the first method to run in 
the new thread. 

To launch a new thread, you need a Runnable to pass 
to the Thread’s constructor. 

A thread is in the NEW state when you have 
instantiated a Thread object but have not yet called 
start()_ 

When you start a thread (by calling the Thread object’s 
start() method), a new stack is created, with the 
Runnable’s run() method on the bottom of the stack. 
The thread is now in the RUNNABLE state, waiting to 
be chosen to run. 

A thread is said to be RUNNING when the JVM’s 
thread scheduler has selected it to be the currently- 
running thread. On a single-processor machine, there 
can be only one currently-running thread. 

Sometimes a thread can be moved from the RUNNING 
state to a BLOCKED (temporarily non-runnable) state. 
A thread might be blocked because it’s waiting for data 
from a stream, or because it has gone to sleep, or 
because it is waiting for an object’s lock. 

Thread scheduling is not guaranteed to work in any 
particular way, so you cannot be certain that threads 
will take turns nicely. You can help influence turn-taking 
by putting your threads to sleep periodically. 
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Putting a thread to sleep 



One of the best ways to help your threads take turns is 
to put them to sleep periodically. All you need to do 
is call the static sleep () method, passing it the sleep 
duration, in milliseconds. 

For example: 

Thread.sleep(2000); 

will knock a thread out of the running state, and 
keep it out of the runnable state for two seconds. 
The thread can’t become the running thread 
again until after at least two seconds have passed. 

A bit unfortunately, the sleep method throws an 
InterruptedException, a checked exception, so all 
calls to sleep must be wrapped in a try/catch (or 
declared). So a sleep call really looks like this: 

try { 

Thread.sleep(2000); 
catch(InterruptedException ex) { 
ex.printStackTrace(); 


Your thread will probably never be interrupted from 
sleep; the exception is in the API to support a thread 
communication mechanism that almost nobody uses in 
the Real World. But, you still have to obey the handle 
or declare law, so you need to get used to wrapping your 
sleep () calls in a try/catch. 


Now you know that your thread won’t wake up before the 
specified duration, but is it possible that it will wake up 
some time after the ‘timer’ has expired? Yes and no. It 
doesn’t matter, really, because when the thread wakes 
up, it always goes back to the runnable state! The thread 
won’t automatically wake up at the designated time and 
become the currently-running thread. When a thread 
wakes up, the thread is once again at the mercy of 
the thread scheduler. Now, for applications that don’t 
require perfect timing, and that have only a few threads, 
it might appear as though the thread wakes up and 
resumes running right on schedule (say, after the 2000 
milliseconds). But don’t bet your program on it. 


Put your Aread to sleep 
if you want to be sure 
Aat odiep Areacfe get a 
chance to pun. 

她 en Ae Aread wakes 
up, it always goes back 
to Ae runnable state 
and waits for Ae thread 
Scheduler to choose it 
to run again. 
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using Thread.sleep() 


Using sleep to make our program 
more predictable. 

Remember our earlier example that kept giving us different 
results each time we ran it? Look back and study the code 
and the sample output. Sometimes main had to wait until the 
new thread finished (and printed “top o’ the stack’’），while 
other times the new thread would be sent back to runnable 
before it was finished, allowing the main thread to come back 
in and print out “back in main”. How can we fix that? Stop 
for a moment and answer this question: “Where can you put 
a sleep () call, to make sure that “back in main” always prints 
before “top o’ the stack ”？ 

We’ll wait while you work out an answer (there’s more than 
one answer that would work). 

Figure it out? 


public class MyRunnable implements Runnable { 


public void run() { 

go(); 


This IS Y/Ka*t v/c a doi^sis 七 ⑺七 order 


File Edit Window Help SnoozeButton 

% j ava 

ThreadTestDrive 

back in 

main 

top o ' 

the stack 

% j ava 

ThreadTestDrive 

back in 

main 

top o' 

the stack 

% j ava 

ThreadTestDrive 

back in 

main 

top o ' 

the stack 

% j ava 

ThreadTestDrive 

back in 

main 

top o' 

the stack 

% j ava 

ThreadTestDrive 

back in 

main 

top o' 

the stack 


public void go () { 


try { 

Thread.sleep(2000); 

} catch(InterruptedException ex) { 
ex.printStackTrace(); 


doMore(); 




祕 ！ 


二一批 ad 




public void doMore() { 

System, out .print In (''top o r the stack"); 


class ThreadTestDrive { 

public static void main (String[] args) { 
Runnable theJob = new MyRunnable(); 
Thread t = new Thread(theJob); 
t.start(); 

System. out. println (''back in main 〃）； 
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Makmg and starting ^threads 

Threads have names. You can give your threads a name of 
your choosing, or you can accept their default names. But the 
cool thing about names is that you can use them to tell which 
thread is running. The following example starts two threads. 
Each thread has the same job: run in a loop, printing the 
currently-running thread’s name with each iteration. 


public class RunThreads implements Runnable { 




OT^t 


R 神 aWc 


public static void main(String[] args) { 

RunThreads runner = new RunThreads() 

Thread alph a = new Thread (runner) 耻七 ^ ^ ^ • 

same job-we ll talk mojrc about the thv-cads 


Thread beta = new Thread(runner); 

alpha. setName (''Alpha thread ); 於 .- D , , w n - - 

beta. setName (''Beta thread") ; ohc Uhi^a c ih a -few pages). 

alpha• start () ; i^c ih^ds. 

beta.start(); ^ - 


Sta\rt the thv-cads. 


一 


public void run () { 

for (int i = 0; i < 25; i++) { 

String threadName = Thread.currentThread().getName() 
System, out .pr in tin (threadName + '' is running"); 


What will happen? 


P3v**t o-p -the ou-tpu-t v/hey) 
the loop itev-ates TJy 
tiroes. 


Will the threads take turns? Will you see the thread names 
alternating? How often will they switch? With each iteration? 
After five iterations? 


You already know the answer: we don’t know! It’s up to the 
scheduler. And on your OS, with your particular JVM, on 
your CPU, you might get very different results. 

Running under OS X 10.2 (Jaguar), with five or fewer 
iterations, the Alpha thread runs to completion, then 
the Beta thread runs to completion. Very consistent. Not 
guaranteed, but very consistent. 

But when you up the loop to 25 or more iterations, things 
start to wobble. The Alpha thread might not get to complete 
all 25 iterations before the scheduler sends it back to 
runnable to let the Beta thread have a chance. 


File Edit Window Help Centauri 
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aren’t threads wonderful? 



Urn, yes. There IS a dark side. 

Threads caw lead to concurrency Issues' 

Concurrency issues lead to race conditions. Race conditions 
lead to data corruption. Data corruption leads to fear... you 
know the rest. 


It all comes down to one potentially deadly scenario: two or 
more threads have access to a single object’s data. In other 
words, methods executing on two different stacks are both 
calling, say, getters or setters on a single object on the heap. 

It’s a whole ‘left-hand-doesn’t-know-what-the-right-hand- 
is-doing’ thing. Two threads, without a care in the world, 
humming along executing their methods, each thread 
thinking that he is the One True Thread. The only one 
that matters. After all, when a thread is not running, and in 
runnable (or blocked) it’s essentially knocked unconscious. 
When it becomes the currently-running thread again, it doesn’t 
know that it ever stopped. 


504 


chapter 15 




networking and threads 


Marriage in Trouble. 

Can this couple be saved? 

Next，on a very special Dr. Steve Show 

[Transcript from episode #42] 

Welcome to the Dr. Steve show. 



We’ve got a story today that’s centered around the top two reasons why- 
couples split up—finances and sleep. 

Todays troubled pair, Ryan and Monica, share a bed and a 
bank account. But not for long if we can’t find a solution. The 
problem? The classic “two people—one bank account” thing. 

Here’s how Monica described it to me ： 

“Ryan and I agreed that neither of us will overdraw the checking account. 
So the procedure is, whoever wants to withdraw money must check the 
balance in the account before making the withdrawal. It all seemed so 
simple. But suddenly we’re bouncing checks and getting hit with overdraft 
fees! 

I thought it wasn’t possible, I thought our procedure was safe. But then 
this happened: 



/Wohi ^： vi^ii r 


Ryan needed $50, so he checked the balance in the account, 
and saw that it was $100. No problem. So, he plans to 
withdraw the money. But first he falls asleep! 

And that’s where I come in, while Ryan’s still asleep, and 
now I want to withdraw $100.1 check the balance, and 
it’s $100 (because Ryan’s still asleep and hasn’t yet made 
his withdrawal), so I think, no problem. So I make the 
withdrawal, and again no problem. But then Ryan wakes * up, 
completes his withdrawal, and we’re suddenly overdrawn! He didn’t 



^ asleep 

“^3 •“ c : akcs 

vap, V>c cs 

如 ㈣ 如 a^am 


even know that he fell asleep, so he just went ahead and completed his 
transaction without checking the balance again. You’ve got to help us Dr. 
Steve!” 


Is there a solution? Are they doomed? We can’t stop Ryan from falling 
asleep, but can we make sure that Monica can’t get her hands on the bank 
account until after he wakes up? 


Take a moment and think about that while we go to a commercial break. 
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The Ryan and Monica problem, m code 


The following example shows what can happen when two 
threads (Ryan and Monica) share a single object (the bank 
account). 

The code has two classes, BankAccount, and 
MonicaAndRyanJob. The MonicaAndRyanJob class 
implements Runnable, and represents the behavior that Ryan 
and Monica both have — checking the balance and making 
withdrawals. But of course, each thread falls asleep in between 
checking the balance and actually making the withdrawal. 

The MonicaAndRyanJob class has an instance variable of type 
BankAccount., that represents their shared account. 

The code works like this: 


① Make one instance of RyanAndMonicaJob. 

The RyanAndMonicaJob class is the Runnable (the job to do), 
and since both Monica and Ryan do the same thing (check 
balance and withdraw money), we need only one instance. 

RyanAndMonicaJob the Job = new RyanAndMonicaJob () 

② Make two threads with the same Runnable 

(the RyanAndMonicaJob instance) 



In the run() method, do 
exactly what Ryan and 
Monica would do — check 
the balance and, if 
there’s enough money, 
make the withdrawal. 


Thread one = new Thread(theJob); 
Thread two = new Thread(theJob); 


③ Name and start the threads 

one . setName (''Ryan"); 
two. setName (''Monica"); 
one.start(); 
two.start(); 


④ Watch both threads execute the run() method 

(check the balance and make a withdrawal) 


This should protect 
against overdrawing the 
account. 

Except... Ryan and 
Monica always fall 
asleep after they 
check the balance but 
before they finish the 
withdrawal. 


One thread represents Ryan, the other represents Monica. 

Both threads continually check the balance and then make a 
withdrawal, but only if \Ys safe! 
if (account.getBalance() >= amount) { 
try { 

Thread.sleep(500); 

} catch(InterruptedException ex) {ex.printstackTrace(); } 
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The Ryah and Monica example 


class BankAccount { 

private int balance = 100 ; 女 


public int getBalance () 
return balance; 




public void withdraw (int amount) 
balance = balance - amount; 


ol< tV'C 




public class RyanAndMonicaJob implements Runnable { 
private BankAccount account = new BankAccount(); 

public static void main (String [] args) { 

RyanAndMonicaJob the Job = new RyanAndMonicaJob () 
Thread one = new Thread(theJob);4^. 

；<~ 




^~ - Ihs 


Thread two 




one. setName (''Ryan") 
two. setName (''Monica") 
one.start(); 
two.start(); 


new Thread (theJob) ; 4 - - 


Uii3ie ^ ^bi e (job) 




v ^iM 






Ohc 




-to w 

如 vk^dbrawal ， 


二 ㈣ 5^5 


… ts : 二二 


public void run () { 
for (int x = 0 ; x < 10 ; x++) { 

makeWithdrawl(10); 

if (account.getBalance() < 0 ) { - ,. 扣。 娜 

System, out.println (''Overdrawn! "> ; attowb' s ° vcyr 

} } c—k 仏 c a^ouy>t kala^c, a^A ^ r.oi 


七 k y/rtv^av/al, 产 tlike 扣山 d . 


private void makeWithdrawal (int amount) { 
if (account.getBalance() >= amount) { 

System, out .println (Thread. currentThread () .getName () + '' is about to withdraw"); 
try { 

System. out. println (Thread. currentThread () . getName () + '' is going to sleep"); 
Thread.sleep(500); 

} catch(InterruptedException ex) {ex.printstackTrace(); } 

System, out.println (Thread. currentThread () . getName () + '' woke up •"); 
account.withdraw(amount); 

System.out.println(Thread.currentThread().getName() + '' completes the withdrawl"); 

} 

else { 

System, out .println (''Sorry, not enough for '' + Thread. currentThread () . getName ()); 




so wc e ， av\ 


\ruhs. 
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Ryan is about to withdraw 
Ryan is going to sleep 
Monica woke up. 

Monica completes the withdrawl 
Monica is about to withdraw 
Monica is going to sleep 
Ryan woke up. 

Ryan completes the withdrawl 
Ryan is about to withdraw 
Ryan is going to sleep 
Monica woke up. 

Monica completes the withdrawl 
Monica is about to withdraw 
Monica is going to sleep 
Ryan woke up. 

Ryan completes the withdrawl 
Ryan is about to withdraw 
Ryan is going to sleep 
Monica woke up. 

Monica completes the withdrawl 
Sorry, not enough for Monica 

Sorry, not enough for Monica 

Sorry, not enough for Monica 

Sorry, not enough for Monica 

Sorry, not enough for Monica 

Ryan woke up. 

Ryan completes the withdrawl 
Overdrawn! 

Sorry, not enough for Ryan 
Overdrawn! 

Sorry, not enough for Ryan 
Overdrawn! 

Sorry, not enough for Ryan 
Overdrawn! 


The makeWithdrawal() method 
always checks the balance 
before making a withdrawal, 
but still we overdraw the 
account. 


Here 9 s one scenario: 

Ryan checks the balance, sees that 
there’s enough money, and then falls 
asleep. 

Meanwhile, Monica comes in and checks 
the balance. She, too, sees that there’s 
enough money. She has no idea that 
Ryan is going to wake up and complete a 
withdrawal. 

Monica falls asleep. 

Ryan wakes up and completes his 
withdrawal. 

Monica wakes up and completes her 
withdrawal. Big Problem! In between the 
time when she checked the balance and 
made the withdrawal, Ryan woke up and 
pulled money from the account. 

Monica’s check of the account was 
not valid, because Ryan had already 
checked and was still in the middle of 
making a withdrawal. 

Monica must be stopped from getting 
into the account until Ryan wakes up and 
finishes his transaction. And vice-versa. 
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They need a lock for account access! 


The lock works like this: 


① There's a lock associated with the bank 
account transaction (checking the balance 
and withdrawing money). There's only 
one key, and it stays with the lock until 
somebody wants to access the account. 



The bank account 
transaction is 
unlocked when 
nobody is using 
the account. 


② When Ryan wants to access the bank 

account (to check the balance and withdraw 
money), he locks the lock and puts the key 
in his pocket. Now nobody else can access 
the account, since the key is gone. 



When Ryan 
wants to access 
the account，he 
secures the lock 
and takes the key. 


③ Ryan keeps the key in his pocket until he 
finishes the transaction. He has the only 
key, so Monica cant access the account 
(or the checkbook) until Ryan unlocks the 
account and returns the key. 

Now, even if Ryan falls asleep after he 
checks the balance, he has a guarantee 
that the balance will be the same when he 
wakes up, because he kept the key while he 
was asleep! 



When Ryan is 
finished, he 
unlocks the lock 
and returns the 
key. Now the key 
is available for 
Monica (or Ryan 
again) to access 
the account. 
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using synchronized 


Wc need the makeWithdrawal () method 
to run as om atomic thmq. 

We need to make sure that once a thread enters the 
makeWithdrawal () method, it must be allowed to finish the method 
before any other thread can enter. 

In other words, we need to make sure that once a thread has 
checked the account balance, that thread has a guarantee that it can 
wake up and finish the withdrawal before any other thread can check the 
account balance! 

Use the synchronized keyword to modify a method so that only 
one thread at a time can access it. 




The synchronized 

keyword means that 
a thread needs a key 
in order to access the 
synchronized code. 


That’s how you protect the bank account! You don’t put a lock on 
the bank account itself; you lock the method that does the banking 
transaction. That way, one thread gets to complete the whole 
transaction, start to finish, even if that thread falls asleep in the 
middle of the method! 

So if you don’t lock the back account, then what exactly is locked? Is 
it the method? The Runnable object? The thread itself? 

We’ll look at that on the next page. In code, though, it’s quite 
simple — just add the synchronized modifier to your method 
declaration: 


To protect your data 
(like the bank account )， 
synchronize the 
methods that act on 
that data. 


private synchronized void makeWithdrawal (int amount) { 


if (account.getBalance() >= amount) { 

System.out.println(Thread.currentThread().getName() + 
try { 

System.out.println(Thread.currentThread().getName() 

Thread.sleep(500); 

} catch(InterruptedException ex) {ex.printstackTrace() 

System.out.println(Thread.currentThread().getName() + 
account.withdraw(amount); 

System.out.println(Thread.currentThread().getName() + 

} else { 

System, out .println (''Sorry, not enough for '' + Thread. currentThread () . getName ()); 



is about to withdraw"); 

'' is going to sleep"); 

} 

woke up•"); 

completes the withdrawl"); 


(Moic -fov you pliysids-savvy vcadcvs ： yes, 七 lie donvcntion of using 七 lie y/ovd 七 omid’ Kcvc does no 七 七 

wiiolc subatomid pavdtidlc TKirvk hlcvjiom, r\oi y/Kcn you Kcav y/ovd m tiic 

of 七 Wcads ov *bransad 七 ions. Hey ； it’s no 七 OUR donvcntion. l-f IV6 y/eve m dKavgc, we’d apply 

Pvmdiplc 七 o pvrbty mudii cvcvy-tiimj vclatcd *to 七 iivcads.) 
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Using an object's lock 

Every object has a lock. Most of the time, the 
lock is unlocked, and you can imagine a virtual 
key sitting with it. Object locks come into play 
only when there are synchronized methods. 
When an object has one or more synchronized 
methods, a thread can enter a synchronized 
method only if the thread can get the key to the 
object’s lock! 

The locks are not per method, they 
are per object. If an object has two 
synchronized methods, it does not 
simply mean that you can’t have two 
threads entering the same method. It 
means you can’t have two threads entering 
any of the synchronized methods. 

Think about it. If you have multiple 
methods that can potentially act on an 
object’s instance variables, all those methods 
need to be protected with synchronized. 

The goal of synchronization is to protect 
critical data. But remember, you don’t lock the 
data itself, you synchronize the methods that 
access that data. 

So what happens when a thread is cranking 
through its call stack (starting with the run() 
method) and it suddenly hits a synchronized 
method? The thread recognizes that it needs 
a key for that object before it can enter the 
method. It looks for the key (this is all handled 
by the JVM; there’s no API in Java for accessing 
object locks), and if the key is available, the 
thread grabs the key and enters the method. 

From that point forward, the thread hangs on 
to that key like the thread’s life depends on 
it. The thread won’t give up the key until it 
completes the synchronized method. So while 
that thread is holding the key, no other threads 
can enter any of that object’s synchronized 
methods, because the one key for that object 
won’t be available. 



Hey, this object's 
takeMoney() method is 
synchronized. I need to get 
this object’s key before I 


can go in. 





Every Java object has a lock. 
A lock has only one ley. 

Most of Ae time, the lock is 
imlocted and nobody cares. 

But if an object has 
syncliPonized mediods, a 
thread can enter one of Ae 
synchponized mediods ONLY 
if the ley for ihe object’s loet 
is available. In odier words, 
only if anodier Aread hasn’t 
already grabbed Ae one ley. 
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The dreaded "Lost Update" problem 


Here’s another classic concurrency problem, that comes from the database world. It’s 
closely related to the Ryan and Monica story, but we’ll use this example to illustrate a few 
more points. 

The lost update revolves around one process: 

Step 1: Get the balance in the account 

int i = balance; 

Step 2: Add 1 to that balance 

balance = i + 1; 

The trick to showing this is to force the computer to take two steps to complete the change 
to the balance. In the real world, you’d do this particular move in a single statement: 

balance++; 

But by forcing it into two steps, the problem with a non-atomic process will become clear. 
So imagine that rather than the trivial “get the balance and then add 1 to the current 
balance” steps, the two (or more) steps in this method are much more complex, and 
couldn’t be done in one statement. 


In the “Lost Update” problem, we have two threads, both trying to increment the balance. 

class TestSync implements Runnable { 


private int balance; 

public void run() { 

for(int i = 0; i < 50; i++) { 
increment(); 

System. out. println (''balance is 

} 

} 


t . tjo t〆 ， 


+ balance) 


public void increment() 
int i = balance; 
balance = 



public class TestSyncTest { 

public static void main (String[] args) { 
TestSync job = new TestSync(); 

Thread a = new Thread(job); 

Thread b = new Thread(job); 

a. start (); 

b. start (); 


^ Clrc s ^ w . 

1 七。 ^ ^ by 

•i nrr T 1 airrrQ 、 i 
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Let's ruw this code... 


① Thread A runs for awhile 



Put the value of balance into variable i. 
Balance is 0, so i is now 0. 

Set the value of balance to the result of i + 1. 
Now balance is 1. 

Put the value of balance into variable i. 
Balance is 1, so i is now 1. 

Set the value of balance to the result of i + 1. 
Now balance is 2. 


② Thread B runs for awhile 

Put the value of balance into variable i. 



Balance is 2, so i is now 2. 

Set the value of balance to the result of i 
Now balance is 3. 

Put the value of balance into variable i. 
Balance is 3, so i is now 3. 

[now thread B is sent back to runnable, 
before it sets the value of balance to 4] 


③ Thread A runs again, picking up where it left off 

Put the value of balance into variable i. 



Balance is 3, so i is now 3. 

Set the value of balance to the result of i + 1 
Now balance is 4. 

Put the value of balance into variable i. 
Balance is 4, so i is now 4. 

Set the value of balance to the result of i + 1 
Now balance is 5. 



④ Thread B runs again, and picks up exactly where it left off! 

/ Set the value of balance to the result of i + 1. 



Now balance is 4. 


Thread A updated »*b io but 

y\OY/ 3 b3dk 3y\d 

tof of update A 

as i-f A ，s 外 date never 


We lost the last updates 
that Thread A made! 

Thread B had previously 
done a £ read 9 of the value 
of balance, and when B 
woke up, it just kept going 
as if it never missed a beat. 
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Make the mcrcmcwtO method atomic. 
Sywchrowizc it! 



Synchronizing the increment () method solves the “Lost 
Update” problem, because it keeps the two steps in the method 
as one unbreakable unit. 


public synchronized void increment() { 
int i = balance; 
balance = i + 1; 


Once a thread enters 
the method, we have 
to make sure that all 
the steps in the method 
complete (as one 
atomic process) before 
any other thread can 
enter the method. 



Sounds like it’s a good idea to synchronize 
everything, just to be thread-safe. 


Nope, it’s not a good idea. Synchronization doesn’t 
come for free. First, a synchronized method has a certain 
amount of overhead. In other words, when code hits a 
synchronized method, there’s going to be a performance hit 
(although typically, you’d never notice it) while the matter of 
"is the key available?” is resolved. 

Second, a synchronized method can slow your program 
down because synchronization restricts concurrency. In 
other words, a synchronized method forces other threads to 
get in line and wait their turn.This might not be a problem 
in your code, but you have to consider it. 

Third, and most frightening, synchronized methods can lead 
to deadlock! (See page 516.) 

A good rule of thumb is to synchronize only the bare 
minimum that should be synchronized. And in fact,you 
can synchronize at a granularity that’s even smaller than 
a method. We don’t use it in the book, but you can use the 
synchronized keyword to synchronize at the more fine¬ 
grained level of one or more statements, rather than at the 
whole-method level. 


public void go() 
doStuff(); 


doS*tuWO doesn't io 

be so v/c Aov\ *t 

s^v\CM>roY\\zJt >w^olc method. 



synchronized(this) { 
criticalStuff(); 
moreCriticalStuff() 



士 U J … d:hod cd: 严 。 忒 

4 叶 Provide ^ 匕 : 卜 if 

will 以 ㉟ 二 - ， to d 。 ， 

method sy^hvohi^d. 
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① Thread A runs for awhile 



Attempt to enter the increment() method. 


The method is synchronized, so get the key for this object 
Put the value of balance into variable i. 

Balance is 0, so i is now 0. 

Set the value of balance to the result of i + 1. 

Now balance is 1. 

Return the key (it completed the increment() method). 
Re-enter the increment() method and get the key. 


Put the value of balance into variable i. 


Balance is 1, so i is now 1. 


[now thread A is sent back to runnable, but since it has not 
completed the synchronized method, Thread A keeps the key] 


② Thread 



B is selected to run 

Attempt to enter the increment() method. The method is 
synchronized, so we need to get the key. 

The key is not available. 

[now thread B is sent into a ‘object lock not available lounge] 


③ Thread A runs again, picking up where it left off 
^ (remember, it still has the key) 

Set the value of balance to the result of i + 1. 

Now balance is 2. 

Return the key. 

[now thread A is sent back to runnable, but since it 
has completed the increments method, the thread 
does NOT hold on to the key] 



④ Thread B is selected to run 



Attempt to enter the increment() method. The method is 
synchronized, so we need to get the key. 

This time, the key IS available, get the key. 

Put the value of balance into variable i. 

[continues to run...] 
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thread deadlock 


All it takes for 
deadlock are two 
objects and two 
threads. 



Thread A wakes up (still 
holding the foo key) 
and tries to enter a 
synchronized method on 
object bar, but can’t get 
that key because B has 
it. A goes to the waiting 
lounge, until the bar key is 
available (it never will be!) 



Thread A can’t run until 
it can get the bar key, 
but B is holding the bar 
key and B can’t run until it 
gets the foo key that A is 
holding and... 


The deadly side of synchronization 

Be careful when you use synchronized code, because nothing 
will bring your program to its knees like thread deadlock. 
Thread deadlock happens when you have two threads, both of 
which are holding a key the other thread wants. There’s no way 
out of this scenario, so the two threads will simply sit and wait. 
And wait. And wait. 

If you’re familiar with databases or other application servers, 
you might recognize the problem; databases often have a 
locking mechanism somewhat like synchronization. But a 
real transaction management system can sometimes deal with 
deadlock. It might assume, for example, that deadlock might 
have occurred when two transactions are taking too long to 
complete. But unlike Java, the application server can do a 
“transaction rollback” that returns the state of the rolled-back 
transaction to where it was before the transaction (the atomic 
part) began. 

Java has no mechanism to handle deadlock. It won’t even know 
deadlock occurred. So it’s up to you to design carefully. If you 
find yourself writing much multithreaded code, you might 
want to study “Java Threads” by Scott Oaks and Henry Wong 
for design tips on avoiding deadlock. One of the most common 
tips is to pay attention to the order in which your threads are 
started. 


A simple deadlock scenario: 


① ^ 



Thread A enters a 
synchronized method 
of object foo, and gets 
the key. 


t© 



Thread A goes to 
sleep, holding the 
foo key. 



② ^ 



Thread B enters a 
synchronized method 
of object bar, and gets 
the key. 


IB 



Thread B tries to enter 
a synchronized method 
of object foo, but can’t 
get that key (because 
A has it). B goes 
to the waiting lounge, 
until the foo key is 
available. B keeps the 
bar key. 


00 
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BULLET POINTS_ 

■ The static Thread.sleep() method forces a thread to leave the 
running state for at least the duration passed to the sleep method. 
Thread.sleep(200) puts a thread to sleep for 200 milliseconds. 

■ The sleep() method throws a checked exception (InterruptedException), 
so all calls to sleep() must be wrapped in a try/catch, or declared. 

■ You can use sleep() to help make sure all threads get a chance to run, 
although there’s no guarantee that when a thread wakes up it’ll go to the 
end of the runnable line. It might, for example, go right back to the front. 

In most cases, appropriately-timed sleep() calls are all you need to keep 
your threads switching nicely. 

■ You can name a thread using the (yet another surprise) setName() 
method. All threads get a default name, but giving them an explicit name 
can help you keep track of threads, especially if you’re debugging with 
print statements. 

■ You can have serious problems with threads if two or more threads have 
access to the same object on the heap. 

■ Two or more threads accessing the same object can lead to data 
corruption if one thread, for example, leaves the running state while still 
in the middle of manipulating an object’s critical state. 

■ To make your objects thread-safe, decide which statements should be 
treated as one atomic process. In other words, decide which methods 
must run to completion before another thread enters the same method 
on the same object. 

■ Use the keyword synchronized to modify a method declaration, 
when you want to prevent two threads from entering that method. 

■ Every object has a single lock, with a single key for that lock. Most of the 
time we don’t care about that lock; locks come into play only when an 
object has synchronized methods. 

■ When a thread attempts to enter a synchronized method, the thread 
must get the key for the object (the object whose method the thread 
is trying to run). If the key is not available (because another thread 
already has it), the thread goes into a kind of waiting lounge, until the key 
becomes available. 

■ Even if an object has more than one synchronized method, there is still 
only one key. Once any thread has entered a synchronized method on 
that object, no thread can enter any other synchronized method on the 
same object. This restriction lets you protect your data by synchronizing 
any method that manipulates the data. 
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final chat client 


New and improved SimpleChatClient 


Way back near the beginning of this chapter, we built the SimpleChatClient that could send 
outgoing messages to the server but couldn’t receive anything. Remember? That’s how we 
got onto this whole thread topic in the first place, because we needed a way to do two things 


at once: send messages to the server (interacting with the GUI) while simultaneously reading 
incoming messages from the server, displaying them in the scrolling text area. 


import java.io.*; 
import java.net.*; 
import java.util.*; 
import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 


really /S 



public class SimpleChatClient { 


JTextArea incoming; 
JTextField outgoing; 
BufferedReader reader; 
PrintWriter writer; 
Socket sock; 


public static void main(String[] args) { 

SimpleChatClient client = new SimpleChatClient(); 
client.go(); 


public void go() { 


伽一 _ j KVS 


JFrame frame = new JFrame (''Ludicrously Simple Chat Client"); 

JPanel mainPanel = new JPanel(); 
incoming = new JTextArea(15,50); 
incoming.setLineWrap(true); 
incoming.setWrapStyleWord(true); 
incoming.setEditable(false); 

JScrollPane qScroller = new JScrollPane(incoming); 

qScroller.setVerticalScrollBarPolicy(ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS); 
qScroller. setHorizontalScrollBarPolicy (ScrollPaneConstants . HORIZONTAL 一 SCROLLBAR—NEVER); 
outgoing = new JTextField(20); 

JButton sendButton = new JButton (''Send"); 


sendButton.addActionListener(new SendButtonListener()) 
mainPanel.add(qScroller); 
mainPanel.add(outgoing); 
mainPanel.add(sendButton); 
setUpNetworking(); 



Thread readerThread = new Thread(new IncomingReader()); 
readerThread.start(); 

frame.getContentPane()•add(BorderLayout.CENTER, mainPanel) 
frame.setSize(400,500); 
frame.setVisible(true); 


d ‘饮 心 s 把’ 
(job) ihc 

如 、 displayiha 

么 ㈣： r • 


} // close go 
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private void setUpNetworking() { 


try { 

sock = new Socket (''127 • 0 • 0 • 1 〃， 5000); 

InputstreamReader streamReader = new InputstreamReader(sock.getlnputStream()); 
reader = new BufferedReader(streamReader); 


writer = new PrintWriter(sock.getOutputStream()) 
System, out .println (''networking established"); 
catch(IOException ex) { 


ex.printstackTrace() 


// close setUpNetworking 


WcVc —a 如 


dv\d o 


IT :。 以以一 


public class SendButtonListener implements ActionListener { 
public void actionPerformed(ActionEvent ev) { 
try { 


writer.println(outgoing.getText()); 
writer .flush (); 

} catch(Exception ex) { 
ex.printStackTrace(); 


wtchts of the text held to the 


SCV-VCV. 


outgoing. setText (); 
outgoing.requestFocus(); 


// close inner class 


public class IncomingReader implements Runnable { 
public void run() { 

String message; 
try { 

while ((message = reader.readLine()) != null) { 

System, out .println (''read '' + message); 
incoming. append (message + ''\n^); 

} // close while 

} catch(Exception ex) {ex.printStackTrace();} 

} // close run 

} // close inner class 


iaUk twead docs!! 


} // close outer class 
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m C3de 


The really really simple Chat Server 


You can use this server code for both versions of the Chat Client. Every possible 
disclaimer ever disclaimed is in effect here. To keep the code stripped down to the 
bare essentials, we took out a lot of parts that you’d need to make this a real server. 
In other words, it works, but there are at least a hundred ways to break it. If you 
want a Really Good Sharpen Your Pencil for after you’ve finished this book, come 
back and make this server code more robust. 

Another possible Sharpen Your Pencil, that you could do right now, is to annotate 
this code yourself. You’ll understand it much better if you work out what’s 
happening than if we explained it to you. Then again, this is Ready-bake code, 
so you really don’t have to understand it at all. It’s here just to support the two 
versions of the Chat Client. 


To run the chat client, you need two 
terminals. First, launch this server 
from one terminal, then launch the 
client from another terminal 


import java.io.*; 
import java.net.*; 


import java.util.*; 

public class VerySimpleChatServer { 

ArrayList clientOutputStreams; 

public class ClientHandler implements Runnable { 

BufferedReader reader; 

Socket sock; 

public ClientHandler(Socket clientSocket) { 
try { 

sock = clientSocket; 

InputstreamReader isReader = new InputstreamReader(sock.getlnputStream()); 
reader = new BufferedReader(isReader); 

} catch(Exception ex) {ex.printstackTrace();} 

} // close constructor 

public void run() { 

String message; 
try { 

while ((message = reader.readLine()) != null) { 

System, out .pr in tin (''read '' + message); 
tel IE very one (message); 

} // close while 

} catch(Exception ex) {ex.printStackTrace();} 

} // close run 

} // close inner class 
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public static void main (String[] args) { 
new VerySimpleChatServer().go(); 


public void go() { 

clientOutputStreams = new ArrayList(); 
try { 

ServerSocket serverSock = new ServerSocket(5000); 


while (true) { 

Socket clientSocket = serverSock.accept(); 

PrintWriter writer = new PrintWriter(clientSocket.getOutputStream()); 
clientOutputStreams.add(writer); 


Thread t = new Thread(new ClientHandler(clientSocket)); 
t. start (); 

System, out .println (''got a connection"); 


} catch(Exception ex) { 
ex.printStackTrace(); 

} 

} // close go 


public void tellEveryone(String message) { 

Iterator it = clientOutputStreams.iterator(); 
while(it.hasNext()) { 
try { 

PrintWriter writer = (PrintWriter) it.next(); 
writer.println(message); 
writer .flush (); 

} catch(Exception ex) { 

ex.printStackTrace(); 


} // end while 


} // close tellEveryone 
} // close class 
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Dumb Questions 

What about protecting static 
variable state? If you have static 
methods that change the static variable 
state, can you still use synchronization? 

A. 

Yes! Remember that static 
methods run against the class and not 
against an individual instance of the class. 
So you might wonder whose object’s lock 
would be used on a static method? After 
all, there might not even be any instances 
of that class. Fortunately, just as each 
object has its own lock, each loaded class 
has a lock. That means that if you have 
three Dog objects on your heap,you have 
a total of four Dog-related locks.Three 
belonging to the three Dog instances, 
and one belonging to the Dog class itself. 
When you synchronize a static method, 
Java uses the lock of the class itself. So if 
you synchronize two static methods in a 
single class, a thread will need the class 
lock to enter either of the methods. 

What are thread priorities? I've 
heard that’s a way you can control 
scheduling. 

A. 

Thread priorities might he\p 
you influence the scheduler, but they 
still don’t offer any guarantee. Thread 
priorities are numerical values that tell 
the scheduler (if it cares) how important a 
thread is to you. In general, the scheduler 
will kick a lower priority thread out of the 
running state if a higher priority thread 
suddenly becomes runnable. But... one 
more time, say it with me now,"there 
is no guarantee.” We recommend that 
you use priorities only if you want to 
influence performance, but never, ever 
rely on them for program correctness. 


Why don’t you just synchronize 
all the getters and setters from the 
class with the data you’re trying to 
protect? Like, why couldn’t we have 
synchronized just the checkBalanceO 
and withdraw() methods from class 
BankAccount, instead of synchronizing 
the makeWithdrawalO method from 
the Runnable's class? 

A. 

厂 Y- Actually, we should have 
synchronized those methods, to prevent 
other threads from accessing those 
methods in other ways. We didn’t bother, 
because our example didn’t have any 
other code accessing the account. 

But synchronizing the getters 
and setters (or in this case the 
checkBalanceO and withdrawO) isn’t 
enough. Remember, the point of 
synchronization is to make a specific 
section of code work ATOMICALLY. In 
other words, it’s not just the individual 
methods we care about, it’s methods 
that require more than one step to 
complete] Think about it. If we had not 
synchronized the makeWithdrawalO 
method, Ryan would have checked the 
balance (by calling the synchronized 
checkBalanceO), and then immediately 
exited the method and returned the key! 

Of course he would grab the key again, 
after he wakes up, so that he can call 
the synchronized withdrawO method, 
but this still leaves us with the same 
problem we had before synchronization! 
Ryan can check the balance, go to sleep, 
and Monica can come in and also check 
the balance before Ryan has a chance to 
wakes up and completes his withdrawal. 

So synchronizing all the access methods 
is probably a good idea, to prevent 
other threads from getting in, but you 
still need to synchronize the methods 
that have statements that must execute 
as one atomic unit. 
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- --- - - - - -- -- --- - - - - ---- - - -- 

Tempo Up 

Acoustic Snare □□□□□□□□□□□□□□□□ 


Crash Cymbal 

n |— i n n n n n n n n n n n n n n 

* — ■ * — __ • —- - — - - — - ■ — > ^ — - -— __ . —」-—。——_〖■:— - * —- 1— - -—» 

i empo Down 

Hand Gap 

n n n n n n n n n n n n n n n n 

sendlt 

Hsgh Tom 

I~I i ~ || ~ 11 ~ || ~~ || ~ 11 ~ ||~11 ~ ij ~ 11 ~ || ~ || ~ 11 ~ 11 ~ I 
_ -— — - =— . 

dance beat 4 ^ 


n n i- '' I 厂 rn n n 厂 | 厂 wi M 瞓 — 

__ _ _ _ __ _ __ _ _ _ _ _ _ •.__ _ :___ 

Hi Bongo 


Maracas 

M 0 M _ V _ M 一 ! V — 

* l l ‘ » * » ■ —— _ * 1 » 8 * 1 * __ * * 1 ■ • * * ■ ■ * l • - 


Whistle 

nnnnn n nnnnnnnnnn 


Low Conga 

I ~~ 1' _ ' ' — — ^ 1 _ ~i! ~~11 ~~i 

- • • L . _\ * L_ _! L . _1 1 1_ _J ■ 

Andy: groove #2 

Cowbeff 

nnnnnnnnnnnnnnnn 

Vibraslap 

n i - 1 n n n n n n n n n n n n n n 

—- - —_ ■ — ：■ — - — ■ ■ —- ^— ■ »— ■ ■ — ■ - — ■ • — ■ «—- «— ■ «— - 1—- - — 

Chris: groove2 revised 

Nigel: dance beat 

Low-mid Tom □ □□□□□□□□□QQQQQQ 

High Agogo 

nnnnnnnnnnnnnnnn 
-——==— . — - —=^—— .. —--——=— . ——-——=— . 

Open Hi Conga'~l 厂 ! 厂门厂 | 厂 | 厂 | 厂 | 厂厂 | 

1 - 


认 sd’ 


Tkis is tke last version of tke BeatBox! 


wi-tf )，i ^ at 9^ 


It connects to a simple MusicServer so tkat you can 
senct and receive teat patterns witk otker clients. 

Tke code is really long, so tke complete listing is 
actually in Appendix A. 
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exercise: Code Magnets 



class Accum { 


Code Magnets 

A working Java program is scrambled up on the fridge. Can 
you add the code snippets on the next page to the empty 
classes below, to make a working Java program that pro¬ 
duces the output listed? Some of the curly braces fell on the 
floor and they were too small to pick up, so feel free to add as 
many of those as you need! 


class ThreadOne 


class ThreadTwo 


File Edit Window Help Sewing 


% java TestThreads 
one 98098 
two 98099 


Bonus Question: Why do you think we used the 
modifiers we did in the Accum class? 
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networking and threads 


Code Magnets ， continuect. 


Accum a = Accum.getAccum(); 


Thread one = new Thread(tl); 


catch(interruptedException ex) { } 


System.out 


.println("two -+a.getCount ())； 


ThreadTwo t2 = new ThreadTwo(); 丨 try 


Thr ead two = 


new 


Thread (t2) 



Accum a = Accum.get ac cum(); 


public static Accum getAccum() { 



implements Runnable { 



catch(InterruptedException 


ex) { 



a 


•updateCounter ( 1 )； 



Public i nt 


STetCount() 


private static Accum a = new 


Accum ()； 


public void run() { 


-- 1 

Thread. 

implements Runnable { 


return a 


i^ lc void 





for(int x= 0 ； x < 98• 




public void run () { } [private Accum() { = new ThreadOneQ; 
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exercise solutions 


public Class TestThreads { 取卿細 ^^伽汹 

public static void main(String [] args) { 

ThreadOne tl = new ThreadOne(); 

ThreadTwo t2 = new ThreadTwo(); 

Thread one = new Thread(tl); 

Thread two = new Thread(t2); 


one.start(); 
two.start(); 


class Accum { 

private static Accum a = 
private int counter = 0; 


A a 祕 6 .、 ♦仪 
o? t\ass W 


new Accum(); 



private Accum() { } 

public static Accum 
return a; 

} 

public void updateCounter(int add) { 
counter += add; 


getAccum() { 


Threads from two different classes are updating 
the same object in a third class, because both 
threads are accessing a single instance of Accum. 
The line of code ： 

private static Accum a = new Accum(); creates a 
static instance of Accum (remember static means 
one per class), and the private constructor in 
Accum means that no one else can make an Accum 
object. These two techniques (private constructor 
and static getter method) used together, create 
whafs known as a 'Singleton* - an 00 pattern to 
restrict the number of instances of an object 
that can exist in an application. (Usually, there's 
just a single instance of a Singleton—hence the 
name), but you can use the pattern to restrict the 
instance creation in whatever way you choose.) 


public int getCount() { 
return counter; 

} 

} 

class ThreadOne implements Runnable { 

Accum a = Accum.getAccum(); 
public void run() { 

for(int x=0; x < 98; x++) { 
a.updateCounter(1000); 
try { 

Thread.sleep(50); 

} catch (工 nterruptedException ex) { } 

} 

System, out. println ( "one Ji +a. getCount ()); 


class ThreadTwo implements Runnable { 

Accum a = Accum.getAccum(); 
public void run() { 

for(int x=0; x < 99; x++) { 
a.updateCounter(1); 
try { 

Thread.sleep(50); 

} catch (工 nterruptedException ex) { } 

} 

System.out .println( yi two "+a• getCount ()) 
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Near-miss at the Airlock 

As Sarah joined the on-board development team’s design review meeting , she gazed out 
the portal at sunrise over the Indian Ocean. Even though the ship’s conference room was 
incredibly claustrophobic, the sight of the growing blue and white crescent overtaking night on 


the planet below filled Sarah with awe and appreciation. 

This morning’s meeting was focused on the control systems for the orbiter’s airlocks. 
JVfyS^fCrY As the final construction phases were nearing their end, the number of spacewalks was 
J J scheduled to increase dramatically, and traffic was high both in and out of the ship’s 

airlocks. “Good morning Sarah”，said Tom, “Your timing is perfect, we’re just starting 
the detailed design review.” 



“As you all know”, said Tom, “Each airlock is outfitted with space-hardened GUI 
terminals, both inside and out. Whenever spacewalkers are entering or exiting the orbiter 
they will use these terminals to initiate the airlock sequences.” Sarah nodded, “Tom can 


you tell us what the method sequences are for entry and exit?” Tom rose, and floated to the 


whiteboard, “First, here’s the exit sequence method’s pseudocode”，Tom quickly wrote on the 


board. 

orbiterAirlockExitSequence() 


verifyPortalStatus(); 
pressurizeAirlock(); 


openlnnerHatch(); 
confirmAirlockOccupied (); 
closelnnerHatch(); 


decompressAirlock(); 
openOuterHatch(); 
confirmAirlockVacated (); 


closeOuterHatch(); 

“To ensure that the sequence is not interrupted, we have synchronized all of the 
methods called by the orbiterAirlockExitSequence() method”, Tom explained. “We’d hate to 
see a returning spacewalker inadvertently catch a buddy with his space pants down!” 


Everyone chuckled as Tom erased the whiteboard, but something didn’t feel right 
to Sarah and it finally clicked as Tom began to write the entry sequence pseudocode on the 
whiteboard. “Wait a minute Tom!”, cried Sarah, “I think we’ve got a big flaw in the exit 
sequence design, let’s go back and revisit it, it could be critical!” 


Why did Sarah stop the meeting? What did she suspect? 
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puzzle answers 



What did Sarah know? 


Sarah realized that in order to ensure that the entire exit 
sequence would run without interruption the 

orbiterAirlockExitSequence ( ) method needed to 
be synchronized. As the design stood, it would be possible 
for a returning spacewalker to interrupt the Exit Sequence! 
The Exit Sequence thread couldn’t be interrupted in the 
middle of any of the lower level method calls, but it could be 
interrupted in between those calls. Sarah knew that the entire 
sequence should be run as one atomic unit, and if the orbit 
erAirlockExitSequence ( ) method was synchronized, it 
could not be interrupted at any point. 
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chapter 15 


16 collections and generics 



Sorting is a snap in Java. You have all the tools for collecting and manipulating 
your data without having to write your own sort algorithms (unless you’re reading this right 
now sitting in your Computer Science 101 class, in which case, trust us — you are SO going to be 
writing sort code while the rest of us just call a method in the Java API). The Java Collections 
Framework has a data structure that should work for virtually anything you’ll ever need to do. 
Want to keep a list that you can easily keep adding to? Want to find something by name? Want 
to create a list that automatically takes out all the duplicates? Sort your co-workers by the 
number of times they’ve stabbed you in the back? Sort your pets by number of tricks learned? 
It’s all here... 
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sorting a list 

Tracking song popularity on your jukebox 

Congratulations on your new job — managing the automated 
jukebox system at Lou’s Diner. There’s no Java inside the 
jukebox itself, but each time someone plays a song ' 
song data is appended to a simple text file. 

Your job is to manage the data to track song popularity, 
generate reports, and manipulate the playlists. You’re not 
writing the entire app — some of the other software developer/ 
waiters are involved as well, but you’re responsible for managing 
and sorting the data inside the Java app. And since Lou has a thing 
against databases, this is strictly an in-memory data collection. All 
you get is the file the jukebox keeps adding to. Your job is to take it 
from there. 

You’ve already figured out how to read and parse the file, and so far 
you’ve been storing the data in an ArrayList. 



SongList.txt 


Pink Moon/Nick Drake 
Somersault/Zero 7 
Shiva Moon/Prem Joshua 
Circles/BT 

Deep Channel/Afro Celts 
Passenger/Headmix 
Listen/Tahiti 80 




Challenge #1 

Sort the songs in alphabetical order 

You have a list of songs in a file, where each line 
represents one song, and the title and artist are 
separated with a forward slash. So it should be simple 
to parse the line, and put all the songs in an ArrayList. 

Your boss cares only about the song titles, so for now 
you can simply make a list that just has the song titles. 

But you can see that the list is not in alphabetical 
order... what can you do? 

You know that with an ArrayList, the elements are 
kept in the order in which they were inserted into the 
list, so putting them in an ArrayList won’t take care of 
alphabetizing them, unless... maybe there’s a sort() 
method in the ArrayList class? 
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collections with generics 


Here's what you have so far ： without the sort: 


import java.util.*; 
import j ava.io.*; 

public class Jukeboxl { 





ArrayLis t<String> songList = new ArrayList<String>(); 


public static void main(String[] args) 
new Jukeboxl().go(); 

} 

^ - 〜 

public void go () { 

getSongs(); 

System.out.printIn(songList); 






void getSongs() { 

try { 

File file = new File (''SongList • txt ”）； 

Buf feredReader reader = new Buf feredReader (new FileReader (file)); 


String line = null; 

while ((line= reader.readLine()) != null) { 

addSong(line); 


catch (Exception ex) { 
ex.printStackTrace() 


void addSong(String lineToParse) { 

String [ ] tokens = lineToParse . split (''/’’）； 
songList.add(tokens[0]); 




12 .- 
… C 
Wo 


ohh 

add 

Soh( 




So 

"the 


File Edit Window Help Dance 


% java Jukeboxl 

[Pink Moon, Somersault, 

Shiva Moon, Circles, 

Deep Channel, Passenger, 
Listen] 


T\it 
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•rtWm 七 k ovi^mal ^ 

丁 Vis is KOT al 一 . 


•is 

Y/ 


avc w 


you are here ► 531 





ArrayList API 


Put the ArrayList class does NOT have a sortO method! 


When you look in ArrayList, there doesn’t seem to be any method related to sorting. 
Walking up the inheritance hierarchy didn’t help either — it’s clear that you canH call a sort 
method on the ArrayList. 
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collections with generics 


I do see a collection class 
called TreeSet... and the docs 
say that it keeps your data 
sorted. I wonder if I should be 
using a TreeSet instead of an 
ArrayList... 



ArrayList is wot the only collection 


Although ArrayList is the one you’ll use most often, 

there are others for special occasions. Some of the key 

collection classes include: r ， a wnvrW about VH 

Well ^ mto 


y TreeSet 

Keeps the elements sorted and prevents duplicates. 


move delays a 


ao 

\^i\t \aU> 


> HashMap 

Let’s you store and access elements as name/value pairs. 


> LinkedList 

Designed to give better performance when you insert or delete 
elements from the middle of the collection. (In practice, an 
ArrayList is still usually what you want.) 


y HashSet 

Prevents duplicates in the collection, and given an element, can 
find that element in the collection quickly. 


> LinkedHashMap 

Like a regular HashMap, except it can remember the order in 
which elements (name/value pairs) were inserted, or it can be 
configured to remember the order in which elements were last 
accessed. 
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Collections.sort() 


You could use a TrecSct... 

Or you could use the Colkctiows.sortO method 


If you put all the Strings (the song titles) into a TreeSet instead of 
an ArrayList, the Strings would automatically land in the right place, 
alphabetically sorted. Whenever you printed the list, the elements would 
always come out in alphabetical order. 

And that’s great when you need a set (we’ll 
talk about sets in a few minutes) or when 
you know that the list must always stay 
sorted alphabetically. 

On the other hand, if you don’t need the 
list to stay sorted, TreeSet might be more 
expensive than you need — every time you 
insert into a TreeSet, the TreeSet has to take 
the time to figure out where in the tree the new 
element must go. With ArrayList, inserts can 
be blindingly fast because the new element 
just goes in at the end. 


java.util.Collections 

pi^icvoid copy(Ust destination, List source) 
public static List emptyList() 

public static void filKUst listToFill, Object objToFillltWith) 
public static int frequency(Collection c, Object o) 

public static void reverse(List list) 

public static void rotate(Listlist/intd 

public static vnid shuffle(ListJist) 
public static >^idsort(List list) 
public static bo 


“ 麄八 lr\W 


But you CAN add something to an 
ArrayList at a specific index instead of just at 
the end — there’s an overloaded add() method 
that takes an int along with the element to add. 

So wouldn't it be slower than inserting at the end? 


II many more r 


A ： 


Yes, it’s slower to insert something in an ArrayList 
somewhere other than at the end. So using the overloaded 
add(index, element) method doesn’t work as quickly as calling 
the add(element) — which puts the added element at the end. 
But most of the time you use ArrayLists, you won’t need to put 
something at a specific index. 


… 仏 c Colle 亡 *ti 0hS a ss ，七七 & 

Usi ▲“， 
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七 0 "take Lis-fc. 


I see there’s a LinkedList class, so wouldn’t that be better for 
doing inserts somewhere in the middle? At least if I remember my Data 
Structures class from college... 


A ： 


Yes, good spot.The LinkedList can be quicker when you insert or 
remove something from the middle, but for most applications, the difference 
between middle inserts into a LinkedList and ArrayList is usually not enough 
to care about unless you’re dealing with a huge number of elements. We’ll 
look more at LinkedList in a few minutes. 


k/ i. 4 -w,^ \s NOT real ColUtt'ons 

api . 二？•以⑻ 
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Adding Colkctiows.sorfO to the Jukebox code 


import java•util.*; 
import j ava.io.*; 

public class Jukeboxl { 


ArrayList<String> songList = new ArrayList<String>(); 

public static void main(String[] args) { 

new Jukeboxl().go(); 


The Collections.SortO 
method sorts a list of 
Strings alphabetically. 


public void go() { 

getSongs(); 

System.out.printIn(songList); 

Collections.sort(songList); 
System.out.println(songList) 




void getSongs() { 

try { 

File file = new File (''SongList • txt"); 

Buf feredReader reader = new Buf feredReader (new FileReader (file)); 
String line 二 null; 

while ( (line= reader.readLine()) != null) { 

addSong(line); 


} catch (Exception ex) { 
ex.printStackTrace(); 


void addSong(String lineToParse) { 

String [ ] tokens = lineToParse • split (''/’’）； 
songList.add(tokens[0]); 


File Edit Window Help Chill 


% java Jukeboxl 

[Pink Moon, Somersault, Shiva Moon, Circles, Deep 
Channel A Passenger, Listen] 

[Circles, Deep Channel , Listen, Passenger, Pink 
Moon, Shiva Moon A Somersault] 


从 ter sovt °- 
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sorting your own objects 


Put now you need Song objects, 
wotjust simple Strings. 


Now your boss wants actual Song class instances in the list, not just 
Strings, so that each Song can have more data. The new jukebox 
device outputs more information, so this time the file will have four 
pieces (tokens) instead of just two. 

The Song class is really simple, with only one interesting feature — 
the overridden toString() method. Remember, the toString() 
method is defined in class Object, so every class in Java inherits the 
method. And since the toString() method is called on an object 
when it’s printed (System.out.println(anObject)), you should 
override it to print something more readable than the default 
unique identifier code. When you print a list, the toString() 
method will be called on each object. 

class Song { 

String title; 

String artist 
String rating 
String bpm; 


:如 ““ & 


SongListMore. txt 

Pink Moon/Nick Drake/5 / 80 
Somersault/Zero 7/4/84 
Shiva Moon/Prem Joshua/6/120 
Circles/BT/5/110 
Deep Channel/Afro Celts/4/120 
Passenger/Headmix/4/100 
Listen/Tahiti 80/5/90 


丁 he sohg -file holds (owr 
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p h . d All o( them m ouv- 
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Song(String t. String a. String r. String b) { 
title = t; 

artlst = a; The vav-iablcs av-c all sci m 
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bpm - b, is dv-catcd- 


public String getTitle () 
return title; 

} 

public String getArtist() 
return artist; 

} 

public String getRating() 
return rating; 

} 

public String getBpm() { 

return bpm; 

} 

public String toString() 
return title; 


{ 



T\\t yiicr methods -fov 

-tKc +ou\r a*t*tv-'ibu*tcs. 
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collections with generics 


Changing the Jukebox code to use Songs 
instead of Strings 


Your code changes only a little — the file I/O code is the same, 
and the parsing is the same (String.split()), except this time 
there will be four tokens for each song/line, and all four will be 
used to create a new Song object. And of course the ArrayList 
will be of type <Song> instead of <String>. 



ArrayList<Song> songList = new ArrayList<Song>(); 

public static void main(String[] args) { 

new Jukebox3().go(); 

} 

public void go ( ) { 

getSongs(); 

System.out.printIn(songList); 

Collections.sort(songList); 

System.out.printIn(songList); 


void getSongs() { 

try { 

File file = new File (''SongList • txt"); 

BufferedReader reader = new BufferedReader(new FileReader(file)); 
String line 二 null; 

while ( (line= reader.readLine()) != null) { 

addSong(line); 

} 

} catch (Exception ex) { 
ex.printStackTrace(); 


void addSong(String lineToParse) { 

String [ ] tokens = lineToParse • split (''/’’）； 

Song nextSong = new Song(tokens[0], tokens[1], tokens[2], tokens[3]); 
songList.add(nextSong); 
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Collections.sort() 


It won't compile! 

Something’s wrong... the Collections class clearly shows there’s a 
sort() method, that takes a List. 

ArrayList is-a List, because ArrayList implements the List interface, 
so... it should work. 

But it doesn’t! 

The compiler says it can’t find a sort method that takes an 
ArrayList<Song>, so maybe it doesn’t like an ArrayList of Song 
objects? It didn’t mind an ArrayList<String>, so what’s the 
important difference between Song and String? What’s the 
difference that’s making the compiler fail? 


File Edit Window Help Bummer 


% javac Jukebox3.java 

Jukebox3. java: 15 : cannot find symbol 

symbol : method sort(java.util.ArrayList<Song>) 

location: class java.util.Collections 

Collections.sort(songList); 

A 

1 error 


And of course you probably already asked yourself, “What would it 
be sorting on?” How would the sort method even know what made 
one Song greater or less than another Song? Obviously if you want 
the song’s title to be the value that determines how the songs are 
sorted, you’ll need some way to tell the sort method that it needs 
to use the title and not, say, the beats per minute. 

We’ll get into all that a few pages from now, but first, let’s find out 
why the compiler won’t even let us pass a Song ArrayList to the 
sort() method. 
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collections with generics 


WTF? I have no idea how to 
read the method declaration 
on this. It says that sortQ 
takes a but what is 

T? And what is that big thing 
before the return type? 




The sortO method declaration 


Collections (Java 2 Platform SE 5.0) 


#1 file://yUsers/kathy/Public/doc5/api/indej<.html 



'Q- Google 






extends ConiDarable< 1 




list) 


Sorts the specif ied list into asoending order, according to the natural ordering of its dementi, All 
elements in the list must implement the comparable interface. Forthermore, all elements in tbe list 
must be mutually comparable (that IS, el. compareTo [ e2 ) must not throw a Cla33Ca3tException 
for any elements ei and e2 in the list). 


s 


From the API docs (looking up the java.util.Collections class, and scrolling to the sort() 
method), it looks like the sort() method is declared... strangely. Or at least different from 
anything we’ve seen so far. 

That’s because the sort() method (along with other things in the whole collection framework in 
Java) makes heavy use of generics. Anytime you see something with angle brackets in Java source 
code or documentation, it means generics — a feature added to Java 5.0. So it looks like we’ll 
have to learn how to interpret the documentation before we can figure out why we were able to 
sort String objects in an ArrayList, but not an ArrayList of Song objects. 
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frcwcrics means more type-safety 

We’ll just say it right here_ virtually all of the code you write that deals 
with generics will be collection-related code. Although generics can be used 
in other ways, the main point of generics is to let you write type-safe 
collections. In other words, code that makes the compiler stop you 
from putting a Dog into a list of Ducks. 

Before generics (which means before Java 5.0), the compiler could 
not care less what you put into a collection, because all collection 
implementations were declared to hold type Object. You could put 
anything in any ArrayList; it was like all ArrayLists were declared as 
ArrayList<Object>. 

a 4-V^cvc >m3s v\o 

WITHOUT generics 


Objects go IN as a reference to 
SoccerBall, Fish, Guitar, and 
Car objects 



ArrayList 




And come OUT as a reference of type Object 


WITH generics 




Objects go IN as a reference to 
only Fish objects 





ArrayList<Fish> 




And come out as a reference of type Fish 


Wi 也 generics, you can 
create type - safe collections 
wiere move problems are 
cau^lit at coi»ipile-tii»ie 
instead of runtime. 

Widiout generics, ^ie 
compiler would K^pily let 
you put a into an 

ArrayList 也 at was supposed 
to hold only Cat objects. 


tm 
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Learning generics 

Of the dozens of things you could learn about generics, there are 
really only three that matter to most programmers: 


① Creating instances of generified classes (like ArrayList) 

When you make an ArrayList, you have to tell it the type 
of objects you’ll allow in the list, just as you do with plain 
old arrays. 


new ArrayList<Song>() 


② Declaring and assigning variables of generic types 

How does polymorphism really work with generic 
types? If you have an ArrayList<Animal> reference 
variable, can you assign an ArrayList<Dog> to it? What 
about a List<Animal> reference? Can you assign an 
ArrayList<Animal> to it? You’ll see... 


List<Song> songList = 

new ArrayList<Song>() 


③ Declaring (and invoking) methods that take generic types 

If you have a method that takes as a parameter, say, an void foo (List<Song> list) 

ArrayList of Animal objects, what does that really mean? 

Can you also pass it an ArrayList of Dog objects? We’ll x f 00 (songList) 

look at some subtle and tricky polymorphism issues that 
are very different from the way you write methods that 
take plain old arrays. 

(This is actually the same point as #2, but that shows you 
how important we think it is.) 


But don’t ■ also need to learn how to create my OWN generic 
classes? What if I want to make a class type that lets people 
instantiating the class decide the type of things that class will use? 

A. 

You probably won’t do much of that.Think about it — the API 
designers made an entire library of collections classes covering most of 
the data structures you’d need, and virtually the only type of classes that 
really need to be generic are collection classes. In other words, classes 
designed to hold other elements, and you want programmers using it to 
specify what type those elements are when they declare and instantiate 
the collection class. 

Yes, it is possible that you might want to create generic classes, but that’s 
the exception, so we won’t cover it here. (But you’ll figure it out from the 
things we do cover, anyway.) 
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Using generic CLASSES 

Since ArrayList is our most-used generified type, we’ll 
start by looking at its documentation. They two key areas 
to look at in a generified class are: 

1) The class declaration 

3) The method declarations that let you add elements 


Understanding ArrayList documentation 
(Or, what f s the true meaning of “E ”？） 


Think of “E” as a stand-in for 
type of element you want 
te collection to hold and 
return." (E is for Eleiqent.) 






\ 


s 織 i 敏 


public class ArrayList<E> extends AbstractList<E> implements List<E> 


public boolean add(E o) 


Wcrts tKc 中 tan 七 七 ! Whatever t is 

dcWmmcs y/V^at kmd 铷呼 youve allowed 
io add to i\\t A^ayUst. 


TV^c -type value <E>) 
becomes *biic -type o-f Lis 七 

m-tcv-fa^c as well. 


// more code 


The “E” represents the type used to create an instance 
of ArrayList. When you see an “E” in the ArrayList 
documentation, you can do a mental find/replace to 
exchange it for whatever <type> you use to instantiate 
ArrayList. 

So, new ArrayList<Song> means that “E” becomes “Song ”， 
in any method or variable declaration that uses “E”. 
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Using type parameters with ArrayList 


collections with generics 


THIS code: 

ArrayList<String> thisList = new ArrayList<String> 



Means ArrayList: 

public class ArrayList<E> 


public boolean add(E o) 
// more code 


Is treated by the compiler as: 

public class ArrayList<String> extends AbstractList<String>. . . { 


public boolean add (String o) 
// more code 


In other words, the “E” is replaced by the real type (also called the type parameter) 
that you use when you create the ArrayList. And that’s why the add() method 
for ArrayList won’t let you add anything except objects of a reference type that’s 
compatible with the type of “E”. So if you make an ArrayList<String>, the add() 
method suddenly becomes add (String o). If you make the ArrayList of type Dog, 
suddenly the add() method becomes add (Dog o). 

Is 〃 E 〃 the only thing you can put there? Because the docs for sort used 〃 T’: … 



r \* You can use anything that’s a legal Java identifier. That means anything that you 
could use for a method or variable name will work as a type parameter. But the conven¬ 
tion is to use a single letter (so that’s what you should use), and a further convention is to 
use "T” unless you’re specifically writing a collection class, where you’d use"E〃to repre¬ 
sent the "type of the Element the collection will hold ’： 
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Using generic MET 卿 S 


A generic class means that the class declaration includes a type 
parameter. A generic method means that the method declaration 
uses a type parameter in its signature. 

You can use type parameters in a method in several different ways: 

① Using a type parameter defined in the class declaration 

public class ArrayList<E> extends AbstractList<E> ... { 



When you declare a type parameter for the class, you 
can simply use that type any place that you’d use a 
real class or interface type. The type declared in the 
method argument is essentially replaced with the type 
you use when you instantiate the class. 


(2) Using a type parameter that was NOT defined in the class declaration 



public <T extends Animal> void takeThing (Array Lis t<T> list) 


If the class itself doesn’t use a type parameter, you can still 
specify one for a method, by declaring it in a really unusual 
(but available) space — before the return type. This method says 
that T can be “any type of Animal”. 
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Wait... that can’t be right. If you can 
take a list of Animal, why doiVt you 
just SAY that? Whafs wrong with just 
takeThing(ArrayList<Animal> list)? 



Here's where it gets weird 


This: 

public <T extends Animal> void takeThing (ArrayList<T> list) 

Is NOT the same as this: 

public void takeThing (ArrayList<Animal> list) 

Both are legal, but they’re different'. 

The first one, where <T extends Animal> is part of the method 


declaration, means that any ArrayList declared of a type that is 
Animal, or one of Animal’s subtypes (like Dog or Cat), is legal. 
So you could invoke the top method using an ArrayList<Dog>, 
ArrayList<Cat>, or ArrayList<Animal>. 


But... the one on the bottom, where the method argument is 
(ArrayList<Animal> list) means that only an ArrayList<Animal> 
is legal. In other words, while the first version takes an ArrayList 
of any type that is a type of Animal (Animal, Dog, Cat, etc.), 
the second version takes only an ArrayList of type Animal. Not 
ArrayList<Dog>, or ArrayList<Cat> but only ArrayList<Animal>. 


And yes, it does appear to violate the point of polymorphism, 
but it will become clear when we revisit this in detail at the end 
of the chapter. For now, remember that we’re only looking at 
this because we’re still trying to figure out how to sort() that 
SongList, and that led us into looking at the API for the sort() 
method, which had this strange generic type declaration. 


For now，all you need to know is that the syntax of the top version 
is legal，and that it means you can pass in a ArrayList object 
instantiated as Animal or any Animal subtype. 


And now back to our sort() method... 
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sorting a Song 


This still doesn't 
explain why the sort method 
failed on an A may List of Songs 
but worked for an A may List of 
Strings... 




Remember where we were... 


File Edit Window Help Bummer 


% javac Jukebox3.java 

Jukebox3. java : 15 : cannot find symbol 

symbol : method sort(java.util.ArrayList<Song>) 

location : class j ava.util.Collections 

Collections.sort(songList); 


import j ava.util.*; 
import j ava.io.*; 


error 


public class Jukebox3 { 

ArrayList<Song> songList = new ArrayList<Song>(); 

public static void main(String[] args) { 

new Jukebox3().go(); 


public void go () { 

getSongs(); 

System.out.printIn(songList); 

Collections.sort(songList); 

System.out.printIn(songList); 


,-j. Uvfaks* l*b Y/ovkcd ^ 


void getSongs() { 

try { 

File file = new File (''SongList • txt ”）； 

BufferedReader reader = new BufferedReader(new FileReader(file)); 

String line = null; 

while ( (line= reader.readLine()) != null) { 

addSong(line); 

} 

} catch (Exception ex) { 
ex.printStackTrace(); 

} 

} 

void addSong(String lineToParse) { 

String [ ] tokens = lineToParse • split (''/’’）； 

Song nextSong = new Song(tokens[0], tokens[1], tokens[2], tokens[3]); 
songList.add(nextSong); 
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Revisiting the sortO method 


So here we are, trying to read the sort() method docs to find 
out why it was OK to sort a list of Strings, but not a 
list of Song objects. And it looks like the answer is... 


The sort() method can take only lists 
of Comparable objects. 

Song is NOT a subtype of 
Comparable，so you cannot sort() 
the list of Songs. 




Coogle 


[Method Detail 

sort 

public statici 


super T>> ^V o . . > ^ 

Sons the sp^ed list into, i 、 8 ° r ^jgt<T^ Ust) 

foranyeJemcnts ei and e2 in S * Con，pareTo < e2 ) must not thro W a f eJe ™ ents ^ *e list 

d CIassCas tException 


0 


At least not yet 



public static <T extends Comparable<? super T» void sort(List<T> list) 


TVis says 七 ever 丁 , 尸 must 

be Comfav-ablc^ 


(l^o\rc this pairt -Pov- how. But 
i*Tyo“ i-t just 
that the type pav-a^ctev- -fov- 
Corwpa\rablc rwus*t be o( type T 
o\r OhC o( Vs supcv-typcsJ 


VoiA dan pass *m ov\\y a L*»st (oy 
sub%c o( list, like A^ayUst) 

i\\ai uses a 

*tv^a*t w wter\cU Cow>\>avablc - 



Um... I just checked the docs for 
String, and String doesn’t EXTEND 
Comparable—it IMPLEMENTS it. 

Comparable is an interface. So its nonsense 
to say <T extends Comparable〉. 


public final class String extends Object implements Serializable , 

Comparable<String>, CharSequence 
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the sort() method 


Iw generics, Extends" means 
"fextewds or implements" 


The Java engineers had to give you a way to put a constraint 
on a parameterized type, so that you can restrict it to, say, only 
subclasses of Animal. But you also need to constrain a type to 
allow only classes that implement a particular interface. So 
here’s a situation where we need one kind of syntax to work 
for both situations — inheritance and implementation. In other 
words, that works for both extends and implements. 

And the winning word was... extends. But it really means “is-a ”， 
and works regardless of whether the type on the right is an 
interface or a class. 


In generics, 也 e keyword 
“extends” really means “is - a ”， 
and worfc for BOTH classes 
and interfaces. 


ComPav-ablc is m-tev-f ate, so 

REALLY reads, W T mus-t be a 妒 a 七 

Comparable . 



public static <T extends Comparable<? super T» void sort(List<T> list) 

, T 

I 七 does 灼七 y/hc*thc\r or\ is 

a dlass ov- ’m 七乙 e … you s*till say w c>^*tc^ds w . 


Why didn't they just make a new key word,"is"? 

A. 

Jr \* Adding a new keyword to the language is a REALLY big deal because 
it risks breaking Java code you wrote in an earlier version.Think about 
it — you might be using a variable "is” (which we do use in this book to repre¬ 
sent input streams). And since you’re not allowed to use keywords as identi¬ 
fiers in your code, that means any earlier code that used the keyword before 
it was a reserved word, would break. So whenever there’s a chance for the 
Sun engineers to reuse an existing keyword, as they did here with "extends ’； 
they’ll usually choose that. But sometimes they don’t have a choice... 

A few (very few) new keywords have been added to the language, such 
as assert in Java 1.4 and enum in Java 5.0 (we look at enum in the appen¬ 
dix). And this does break people’s code, however you sometimes have the 
option of compiling and running a newer version of Java so that it behaves 
as though it were an older one. You do this by passing a special flag to the 
compiler or JVM at the command-line, that says,'Teah, yeah, I KNOW this is 
Java 1.4, but please pretend it’s really 1.3, because I’m using a variable in my 
code named assert that I wrote back when you guys said it would OK !#$%’： 

(To see if you have a flag available, type javac (for the compiler) or java (for 
the JVM) at the command-line, without anything else after it, and you should 
see a list of available options. You’ll learn more about these flags in the chap¬ 
ter on deployment.) 
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Finally m know whafs wrong... 

The Song class needs to implement Comparable 


We can pass the ArrayList<Song> to the sort() method only if the 
Song class implements Comparable, since that’s the way the sort() 
method was declared. A quick check of the API docs shows the 
Comparable interface is really simple, with only one method to 
implement: 

java.Iang.Comparable 


public interface Comparable<T> { 
int compareTo(T o); 


And the method documentation for compareTo() says 


Returns: 

a negative integer, zero, or a 
positive integer as this object 
is less than, equal to, or greater 
than the specified object. 


It looks like the compareTo() method will be called on one 
Song object, passing that Song a reference to a different 
Song. The Song running the compareTo() method has to 
figure out if the Song it was passed should be sorted higher, 
lower, or the same in the list. 

Your big job now is to decide what makes one song greater 
than another, and then implement the compareTo() method 
to reflect that. A negative number (any negative number) 
means the Song you were passed is greater than the Song 
running the method. Returning a positive number says 
that the Song running the method is greater than the Song 
passed to the compareTo() method. Returning zero means 
the Songs are equal (at least for the purpose of sorting... it 
doesn’t necessarily mean they’re the same object). You might, 
for example, have two Songs with the same title. 

(Which brings up a whole different can of worms we’ll look 
at later...) 


The big question is: what 
makes one song less than, 
equal to, or greater than 
another song? 

You can’t implement the 
Comparable interface until you 
make that decision. 


—c^^rpen your pencil 


Write in your idea and pseudo code (or 
better, REAL code) for implementing the 
compareToO method in a way that will 
sort() the Song objects by title. 

Hint: if you’re on the right track, it should 
take less than 3 lines of code! 
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the Comparable interface 


The new, improved, comparable Song class 


We decided we want to sort by title, so we implement the compareTo() 
method to compare the title of the Song passed to the method against 
the title of the song on which the compareTo() method was invoked. 
In other words, the song running the method has to decide how its 
title compares to the title of the method parameter. 


Hmmm... we know that the String class must know about alphabetical 
order, because the sort() method worked on a list of Strings. We know 
String has a compareTo() method, so why not just call it? That way, we 


can simply let one title String compare itself to another, and we don’t 
have to write the comparing/alphabetizing algorithm! 


class Song implements Comparable<Song> 
String title; 


Usually type 

he tlass be dompaved 心》衫七 . 

TV»s mcar.s So^ objects be to^cd io 

So” objedts, sort，％. 


String artist; 
String rating; 
String bpm; 



Tk sortO method sends a So% io tompavcToO 
io see 从 at Compares io So 吒 on 

method 'mvokcd- 


public int compareTo(Song s) { 

return title.compareTo(s.getTitle()); 

Song(String t. String a. String r. String b) { 


< - Simple! lA/c Wsi pass i\\t work 

io title Stv-mj objects, 
s\v\U v/C kr\ow Stv-my V^avc d 
tow>pav-cToO mc*t^od- 


title = t; 
artist = ae¬ 


rating =r ; 
bpm = b; 


public String getTitle() { 
return title; 


public String getArtist() { 
return artist; 


public String getRating() { 

return rating; 


public String getBpm() { 

return bpm; 


public String toString() { 

return title; 


TW»S time \i y/ovked. It pv*m*b tails so\rt 

▲•乩 puts 如 So 呼 rn al^abctital order by ht\c 


% java Jukebox3 

[Pink Moon, Somersault, Shiva Moon, Circles, Deep 
Channel, Passenger, Listen] 

[Circles, Deep Channel, Listen, Passenger, Pink 
Moon, Shiva Moon, Somersault] 
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Wccaw sort the list but... 

There’s a new problem — Lou wants two different views of the song list, 
one by song title and one by artist! 

But when you make a collection element comparable (by having it 
implement Comparable), you get only one chance to implement the 
compareTo() method. So what can you do? 

The horrible way would be to use a flag variable in the Song class, 
and then do an if test in compareTo() and give a different result 
depending on whether the flag is set to use title or artist for the 
comparison. 

But that’s an awful and brittle solution, and there’s something much 
better. Something built into the API for just this purpose — when you 
want to sort the same thing in more than one way. 

Look at the Collections class API again. There’s a 
second sort() method — and it takes a Comparator. 



Co (Actions Platform j 

^ file:///Use rs/kaJthy/Public/dacs ^api/index.html :- 

Google 

is Jet Jy vis ion, Inc. Collections ...form 5E 5,0) Caff e tnale d ...d Brain Day Brand Noise 

Djva Marketing » 


static 
<K,V> Hap<K J V> 


T\\t sov 

•take 


to 


^ 。一。 adcd 6 
^ a Co^a ， 


atov*- 


咏 k se 々# 讲 


static 
aper T» 
void 


BingletQDHap f K key, V value} 

Retumii an immutable map, mapping only Ehe 
specified key to the specified value. 


sort{Li3t<T> list) 

Sorts the specified list into ascending order, 


according to the natural ordering of its elements. 



0 
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the Comparator interface 


Usmg a custom Comparator 

An element in a list can compare itself to another of 
its own type in only one way, using its compareTo() 
method. But a Comparator is external to the element 
type you’re comparing — it’s a separate class. So you can 
make as many of these as you like! Want to compare 
songs by artist? Make an ArtistComparator. Sort by beats 
per minute? Make a BPMComparator. 

Then all you need to do is call the overloaded sort() 
method that takes the List and the Comparator that will 
help the sort() method put things in order. 

The sort() method that takes a Comparator will use the 
Comparator instead of the element’s own compareTo() 
method, when it puts the elements in order. In other 
words, if your sort() method gets a Comparator, it won’t 
even call the compareTo() method of the elements 
in the list. The sort() method will instead invoke the 
compare () method on the Comparator. 

So, the rules are: 


java.util.Comparator 


public interface Comparator<T> { 
int compare(T ol, T o2); 


If you pass a Comparator to Ae 
sort() mediod, ^ie sort order is 
detemined by ^ie Coiqparator 
racier 也 an 也 e element’s own 
compareTo() ine^iod. 


> Invoking the one-argument sort(List o) method 
means the list element’s compareTo() method 
determines the order. So the elements in the list 
MUST implement the Comparable interface. 


► Invoking sort(List o, Comparator c) means the 
list element’s compareTo() method will NOT be 
called, and the Comparator’s compare() method 
will be used instead. That means the elements 
in the list do NOT need to implement the 
Comparable interface. 


So does this mean that if you have a class that 
doesn’t implement Comparable, and you don’t have the 
source code, you could still put the things in order by 
creating a Comparator? 

A- 

That’s right.The other option (if it’s possible) would be 
to subclass the element and make the subclass implement 
Comparable. 


But why doesn't every class implement Comparable? 

A. 

Do you really believe that everything can be ordered? 

If you have element types that just don’t lend themselves to 
any kind of natural ordering, then you’d be misleading other 
programmers if you implement Comparable. And you aren't 
taking a huge risk by not implementing Comparable, since 
a programmer can compare anything in any way that he 
chooses using his own custom Comparator. 
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Updating the Jukebox to use a Comparator 

We did three new things in this code: 

1) Created an inner class that implements Comparator (and thus the compare() 
method that does the work previously done by compareTo()). 

2) Made an instance of the Comparator inner class. 

3) Called the overloaded sort() method, giving it both the song list and the 
instance of the Comparator inner class. 

Note: we also updated the Song class toString() method to print both the song 
title and the artist. (It prints title: artist regardless of how the list is sorted.) 


import java.util.*; 
import j ava.io.*; 


public class Jukebox5 { 

ArrayList<Song> songList = new ArrayList<Song>(); 
public static void main(String[] args) { 

new Jukebox5().go(); 




Create a tlass 七 

Comparatov (note 

parameter mattes 如 M 

to tow>pav-c—m tasc objects J 


class ArtistCompare implements Comparator<Song> { 
public int compare (Song one. Song two) { 

return one.getArtist().compareTo(two.getArtist()) 

} - ^ 

} TVis becomes a S*bri^ av 七 is 七） 



public void go() { 

getSongs(); 

System.out.println(songList) 
Collections.sort(songList); 
System.out.println(songList) 




/\/|dke ms*t3r\dc <^f 
Compav-a*tov dass. 


ArtistCompare artistCompare = new ArtistCompare(); 
Collections•sort(songList, artistCompare ); 


System.out.println(songList) 






void getSongs () { 

// 工 /0 code here 

} 

void addSong(String lineToParse) { 

// parse line and add to song list 


Note: we’ve made sort-by-title the default sort, by 
keeping the compareToO method in Song use the 
titles. But another way to design this would be to 
implement both the title sorting and artist sorting as 
inner Comparator classes, and not have Song implement 
Comparable at all.That means we’d always use the two- 
arg version of Collections.sort(). 
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import _; 

public class SortMountains { 


O^^rpen your pencil 


LinkedList 


mtn = new LinkedList 



class NameCompare _ 

public int compare(Mountain one. Mountain two) { 


return 


class HeightCompare 


public int compare(Mountain one. Mountain two) { 


return 


)； 


public static void main(String [] args) { 
new SortMountain().go(); 

} 

public void go() { 

mtn.add(new Mountain("Longs ”， 
mtn.add(new Mountain("Elbert” 
mtn.add(new Mountain("Maroorv 
mtn.add(new Mountain("Castle - 

System.out .println( yi as entered:\n 〃 + mtn); 
NameCompare nc = new NameCompare(); 


n 




14255 )); 
14433 )); 
14156 )); 
14265 )); 


System.out .println( yi by name :\n r, + mtn); 
HeightCompare he = new HeightCompare(); 


Reverse Engineer 

Assume tiiis code exists in 
a Single file. Your job is 
to fill in tire blanks So tire 
tire program will create tire 
output shown. 


Note: answers are at the end of 
the chapter. 


System, out .println( yy by height :\n’’ + 

} 

mtn); 

} 

class Mountain { 


• 

f 

參 

Output: 


File Edit Window Help ThisOne’sForBob 

{ 

% java SortMountains 

參 

as entered: 

f 

參 

[Longs 14255, Elbert 14433, Maroon 14156, Castle 14265] 

f 

} 

by name: 

{ 

[Castle 14265, Elbert 14433, Longs 14255, Maroon 14156] 

參 

f 

by height: 

} 

[Elbert 14433, Castle 14265, Longs 14255, Maroon 14156] 
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c fQ ^pen your pencil 赃鉍 如伽 

For each of the questions below, fill in the blank 
with one of the words from the "possible answers” 
list, to correctly answer the question. Answers are 
at the end of the chapter. 


Possible Answers: 

Comparator, 
Comparable, 
compareTo(), 
compare(), 
yes, 
no 

Given the following compilable statement: 

Collections.sort(myArrayList); 


1. What must the class of the objects stored in myArrayList implement? 


2. What method must the class of the objects stored in myArrayList implement? 

3. Can the class of the objects stored in myArrayList implement both 

Comparator AND Comparable? 


Given the following compilable statement: 

Collections•sort(myArrayList, myCompare); 

4. Can the class of the objects stored in myArrayList implement Comparable? 

5. Can the class of the objects stored in myArrayList implement Comparator? 

6. Must the class of the objects stored in myArrayList implement Comparable? 

7. Must the class of the objects stored in myArrayList implement Comparator? 

8. What must the class of the myCompare object implement? 

9. What method must the class of the myCompare object implement? 











dealing with duplicates 

Uh-oh. The sorting all works, but wow m have duplicates... 

The sorting works great, now we know how to sort on both title (using the Song object’s 
compareTo() method) and artist (using the Comparator’s compare() method). But there’s 
a new problem we didn’t notice with a test sample of the jukebox text file — the sorted list 
contains duplicates. 

It appears that the diner jukebox just keeps writing to the file regardless of whether the 
same song has already been played (and thus written) to the text file. The SongListMore.txt 
jukebox text file is a complete record of every song that was played, and might contain the 
same song multiple times. 


File Edit Window Help TooManyNotes 


% java Jukebox4 


[Pink Moon: Nick Drake , Somersault: Zero 7, Shiva Moon: Prem 
Joshua, Circles : BT, Deep Channel : Afro Celts , Passenger: 
Headmix , Listen: Tahiti 80, Listen: Tahiti 80, Listen: Tahiti 
80, Circles : BT] 


[Circles : BT, Circles : BT, Deep Channel : Afro Celts, Listen: 
Tahiti 80, Listen: Tahiti 80, Listen: Tahiti 80, Passenger: 
Headmix , Pink Moon: Nick Drake, Shiva Moon: Prem Joshua , 
Somersault: Zero 7] 


[Deep Channel : Afro Celts, Circles : BT, Circles : BT, Passenger: 
Headmix , Pink Moon: Nick Drake , Shiva Moon: Prem Joshua, Listen 
Tahiti 80, Listen: Tahiti 80, Listen: Tahiti 80, Somersault: 
Zero 7] 


sov*bm^- 


sov 七…亡 

'^cSo^sow 

avcToO wetnod 

(so\rt >07 


i\st Avt«s-tCom ? ajrC 
Comfava*toy “。 v 七 b 、 

av*b»s*b 灼 awe). 


SongListMore. txt 




Pink Moon/Nick Drake/5 / 80 
Somersault/Zero 7/4/84 
Shiva Moon/Prem Joshua/6/120 
Circles/BT/5/110 
Deep Channel/Afro Celts/4/120 
Passenger/Headmix/4/100 
Listen/Tahiti 80/5/90 
Listen/Tahiti 80/5/90 
Listen/Tahiti 80/5/90 
Circles/BT/5/110 


tent 尸一 ㈣ 
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collections with generics 


Wc need a instead of a list 

From the Collection API, we find three main interfaces, List, Set, and 
Map. ArrayList is a List, but it looks like Set is exactly what we need. 


> LIST - when sequence matters 

Collections that know about index position. 

Lists know where something is in the list. You 
can have more than one element referencing 
the same object. 


y SET - when uniqueness matters 

Collections that do not allow duplicates. 

Sets know whether something is already in the collection. 
You can never have more than one element referencing 
the same object (or more than one element referencing 
two objects that are considered equal—well look at what 
object equality means in a moment). 


MAP- when finding something by key matters 

Collections that use key-value pairs. 

Maps know the value associated with a given key. You 
can have two keys that reference the same value, but you 
cannot have duplicate keys. Although keys are typically 
String names (so that you can make name/value property 
lists, for example), a key can be any object. 



List 




Set 


Pupate values 0^, Ut KO & 处 



Map 
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the collections API 


The Collection API (part of it) 


Notice that the Map interface doesn’t 
actually extend the Collection interface, 
but Map is still considered part of the 
‘Collection Framework” (also known 
as the “Collection API”）. So Maps are 
still collections, even though they don’t 
include java.util.Collection in their 
inheritance tree. 

(Note: this is not the complete 


Collection 

(interface) 


/ 


\ 
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collections with generics 


Using a HashSet instead of ArrayList 

We added on to the Jukebox to put the songs in a HashSet. (Note: we left out some 
of the Jukebox code, but you can copy it from earlier versions. And to make it easier 
to read the output, we went back to the earlier version of the Song’s toString() 
method, so that it prints only the title instead of title and artist.) 


import java.util.*; 
import j ava.io.*; 


public class Jukebox6 { 

ArrayList<Song> songList 
// main method etc. 


new ArrayList<Song>(); 


Wc didn't yts 呼 a so it still f 山如 so 呼 m a” A^ayLisl 


ttcv'C £.v"C3*tc 3 ttasiiSc*t 
pavaw'C'tcviz^d *to hold So 呼 . 

new HashSet<Song>(); 


public void go() 
getSongs(); 

System.out.printIn(songList) 

Collections.sort (songList); 

System.out.printIn(songList) 

HashSet<Song> songSet = 

songSet. addAll (songList) ; n , c , 

System.out.printlntsongSet); 

1 soL otc S san> ± as ^ wc addcd 

/ / getSongs () and addSong () methods siirnplcir). 


File Edit Window Help GetBetterMusic 


% java Jukebox6 


[Pink Moon, Somersault, Shiva Moon, Circles, Deep Channel , 
Passenger f Listen A Listen f Listen, Circles] 

[Circles, Circles, Deep Channel, Listen, Listen, 
Passenger, Pink Moon, Shiva Moon, Somersault] 

Listen, 

[Pink Moon, Listen, Shiva Moon, Circles, Listen, 
Passenger, Circles, Listen, Somersault] 

Deep Channel, 


The didh’ 七 help" 

Wc st,11 ^ all ihc duplies/ 


(A^d \i lost *»*b sort order 
>/c list *m*to d 

Has^ci but v/c II v/ovv-Y about 
oy\c la*bcv*- ) 


Bc-Po 
the 


sov-tiha 

A^ayLisi 


， A-ftcv* sovtrn^ 

(by title)- 

/Vftcv 七 

and 

HashSet duU 

ca\\ so\rt() a — 於 ). 
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object equality 

What makes two objects equal? 

First, we have to ask — what makes two Song references 
duplicates? They must be considered equal. Is it simply two 
references to the very same object, or is it two separate objects 
that both have the same title} 

This brings up a key issue: reference equality vs. object equality. 


> Reference equality 

Two references, one object on the heap. 

Two references that refer to the same object on 
the heap are equal. Period. If you call the hashCode() method on 
both references, you’ll get the same result. If you don’t override the 
hashCode() method, the default behavior (remember, you inherited 
this from class Object) is that each object will get a unique number 
(most versions of Java assign a hashcode based on the object's 
memory address on the heap, so no two objects will have the same 
hashcode). 

If you want to know if two references are really referring to the same 
object, use the == operator, which (remember) compares the bits in 
the variables. If both references point to the same object, the bits will 
be identical. 


If two objects foo and bar are 
equal, foo.equals(bar) must be 
true, and both foo and bar must 
return the same value from 
hashCodef). For a Set to treat 
two objects as duplicates, you 
must override the hashCode() 
and equals() methods inherited 
from class Object, so that you 
can make two different objects 
be viewed as equal. 



Song 

if ( foo == bar) { 

// both references are referring 
// to the same object on the heap 


> Object equality 

Two references, two objects on the heap, but 
the objects are considered meaningfully equivalent 

If you want to treat two different Song objects as equal (for 
example if you decided that two Songs are the same if they have 
matching title variables), you must override both the hashCode() 
and equals() methods inherited from class Object. 

As we said above, if you don't override hashCode(), the default 
behavior (from Object) is to give each object a unique hashcode 
value. So you must override hashCode() to be sure that two 
equivalent objects return the same hashcode. But you must also 
override equals() so that if you call it on either object, passing in 
the other object, always returns true. 



Song 


Song 


if ( foo.equals(bar) && foo•hashCode() == bar.hashCode()) { 

// both references are referring to either a 


// a single object, or to two objects that are equal 
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How a HashSet checks for duplicates: hashCodeOand equals!) 


When you put an object into a Hashset, it uses the 
object’s hashcode value to determine where to put 
the object in the Set. But it also compares the object’s 
hashcode to the hashcode of all the other objects in 
the HashSet, and if there’s no matching hashcode, 
the HashSet assumes that this new object is not a 
duplicate. 

In other words, if the hashcodes are different, the 
HashSet assumes there’s no way the objects can be 
equal! 

So you must override hashCode () to make sure the 
objects have the same value. 

But two objects with the same hashCode() might not 
be equal (more on this on the next page), so if the 


HashSet finds a matching hashcode for two objects— 
one you’re inserting and one already in the set — the 
HashSet will then call one of the object’s equals() 
methods to see if these hashcode-matched objects 
really are equal. 

And if they’re equal, the HashSet knows that the 
object you’re attempting to add is a duplicate of 
something in the Set, so the add doesn’t happen. 

You don’t get an exception, but the HashSet^ add() 
method returns a boolean to tell you (if you care) 
whether the new object was added. So if the add() 
method returns false, you know the new object was a 
duplicate of something already in the set. 



youVc io 

add *to Haslet 


alvcady IN 

=S S 742 V 如 ㈣. 



Objcdt youVc 
七 。 add i*b 
method) ^ompavm^ i*tsCK 
to bav, dr\d 


alvcady 

( =:n 42 V ▲胤 


IN 
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overriding hashCode() and equals() 

The Song class with overridden 
hashCodeO and equals!) 


class Song implements Comparable<Song>{ 

String title; 

String artist; 

String rating; 

string bpm; r 

public boolean equals (Object aSong) { 
Song s = (Song) aSong; 

return getTitle().equals(s.getTitle()) 

} 


-- \ sc 

丁 4 气 (: 匕 So 呒 . 


c tW) s 忧 ds 七 






public int hashCodeO { Sar, c deal he 代 … l 

return title • hashCode () 产 〆 hashCodeO method 5 £ ass ^ as ^ ©vc^iddch 

} “I— hashCodeol diS 切:十 h ，一 W 

釙 d e r alsO a,c usi.a W «odeO 

public int compareTo (Song s) { J r /u- ihst^h^c v^iridble. 

return title.compareTo(s.getTitle()); 


Song(String t. String a, 
title = t; 
artist = ae¬ 
rating =r; 
bpm = b; 


public String getTitle() 
return title; 


String r. String b) 


public String getArtist() { 

return artist; 


public String getRating() 
return rating; 


public String getBpm() { 

return bpm; 

} 

public String toString() 
return title; 


Now i-t v/ovks/ \io duplicates wheh v/e 
pvmi ou-t -the ttashSct Bui wc didr / 七 

乙 all SO\rt0 V/C pU"t 

■the A^-ayLis-t m-to -the ttashSci -the 

HashSrt aid^-t pmcscirvc -the sov-t ov-dev-. 


File Edit Window Help RebootWindows 


% java Jukebox6 

[Pink Moon, Somersault, Shiva Moon, Circles, 
Deep Channel , Passenger, Listen, Listen, 
Listen, Circles] 

[Circles, Circles, Deep Channel, Listen, 
Listen, Listen, Passenger, Pink Moon, Shiva 
Moon, Somersault] 

[Pink Moon, Listen, Shiva Moon, Circles, 

Deep Channel , Passenger, Somersault] 
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^JiereiaireJiP 0 

Dumb Questions 


How come hashcodes can be the same 
even if objects aren't equal? 


HashSets use hashcodes to store the ele¬ 
ments in a way that makes it much faster to access. 
If you try to find an object in an ArrayList by giving 
the ArrayList a copy of the object (as opposed to 
an index value), the ArrayList has to start searching 
from the beginning, looking at each element in 
the list to see if it matches. But a HashSet can find 
an object much more quickly, because it uses the 
hashcode as a kind of label on the "bucket” where 
it stored the element. So if you say/'I want you 
to find an object in the set that’s exactly like this 
one."”the HashSet gets the hashcode value from 
the copy of the Song you give it (say, 742), and 
then the HashSet says,"Oh, I know exactly where 
the object with hashcode #742 is stored."’; and it 
goes right to the #742 bucket. 

This isn’t the whole story you get in a computer 
science class, but it’s enough for you to use Hash- 
Sets effectively. In reality, developing a good hash- 
code algorithm is the subject of many a PhD thesis, 
and more than we want to cover in this book. 

The point is that hashcodes can be the same 
without necessarily guaranteeing that the objects 
are equal, because the"hashing algorithm”used in 
the hashCodeO method might happen to return 
the same value for multiple objects. And yes, that 
means that multiple objects would all land in the 
same bucket in the HashSet (because each bucket 
represents a single hashcode value), but that’s not 
the end of the world. It might mean that the Hash- 
Set is just a little less efficient (or that it’s filled 
with an extremely large number of elements), but 
if the HashSet finds more than one object in the 
same hashcode bucket, the HashSet will simply 
use the equalsO method to see if there’s a perfect 
match. In other words, hashcode values are some¬ 
times used to narrow down the search, but to find 
the one exact match, the HashSet still has to take 
all the objects in that one bucket (the bucket for 
all objects with the same hashcode) and then call 
equalsO on them to see if the object it’s looking for 
is in that bucket. 
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TreeSets and sorting 


Awd if m wawt the set to stay 
sorted, wcVg got TrccSct 


TreeSet is similar to HashSet in that it prevents duplicates. But it also keeps the list sorted. It works 
just like the sort() method in that if you make a TreeSet using the set’s no-arg constructor, the 
TreeSet uses each object’s compareTo() method for the sort. But you have the option of passing 
a Comparator to the TreeSet constructor, to have the TreeSet use that instead. The downside to 
TreeSet is that if you don’t need sorting, you’re still paying for it with a small performance hit. But 
you’ll probably find that the hit is almost impossible to notice for most apps. 

import java.util.*; 
import j ava.io.*; 
public class Jukebox8 { 

ArrayList<Song> songList = new ArrayList<Song>(); 
int val; 

public static void main(String[] args) { 


new Jukebox8().go(); 




void getSongs () { 

try { 


File file = new File (''SongListMore • txt ”）； 

BufferedReader reader = new BufferedReader(new FileReader(file)); 
String line = null; 

while ((line= reader.readLine()) != null) { 

addSong(line); 

} 

} catch(Exception ex) { 
ex.printStackTrace(); 


void addSong(String lineToParse) { 

String [ ] tokens = lineToParse • split (''/’’）； 

Song nextSong = new Song(tokens[0], tokens[1], tokens[2], tokens[3]); 
songList.add(nextSong); 
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What you MUST know about TrccSct... 

TreeSet looks easy, but make sure you really understand what you need to 
do to use it. We thought it was so important that we made it an exercise so 
you’d have to think about it. Do NOT turn the page until you’ve done this. 

We mean it. 



Look at this code. 
Read it carefully, then 
answer the questions 
below. (Note: there 
are no syntax errors 
in this code.) 


import java.util.*; 


public class TestTree { 

public static void main (String[] args) 
new TestTree().go(); 


{ 


public 

Book 

Book 

Book 


void go () { 

bl = new Book (''How Cats Work"); 
b2 = new Book (''Remix your Body 〃）； 
b3 = new Book (''Finding Emo"); 


TreeSet<Book> tree = new TreeSet<Book>(); 
tree.add(bl); 
tree.add(b2); 
tree.add(b3); 

System.out.printin(tree); 


class Book { 

String title; 
public Book(String t) { 
title = t; 


1). What is the result when you compile this code? 


2). If it compiles, what is the result when you run the TestTree class? 


3). If there is a problem (either compile-time or runtime) with this code, how would you fix it? 
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how TreeSets sort 


TrccSct elements MUST be comparable 

TreeSet can’t read the programmer’s mind to figure out how the 
object’s should be sorted. You have to tell the TreeSet how. 


To use a TreeSet，one of these 
things must be true: 


> The elements in 

the list must be of a type that 
implements Comparable 

The Book class on the previous 
page didn’t implement Comparable, so it 
wouldn’t work at runtime. Think about it, the 
poor TreeSet’s sole purpose in life is to keep 
your elements sorted, and once again—it had 
no idea how to sort Book objects! It doesn’t fail 
at compile-time, because the TreeSet add() 
method doesn’t take a Comparable type,The 
TreeSet add() method takes whatever type 
you used when you created the TreeSet. In 
other words, if you say newTreeSet<Book>() 
the add() method is essentially add(Book). And 
there’s no requirement that the Book class 
implement Comparable! But it fails at runtime 
when you add the second element to the set. 
That’s the first time the set tries to call one of 
the object’s compareTo() methods and... can’t. 

OR 

> You use the TreeSet’s 
overloaded constructor 
that takes a Comparator 

TreeSet works a lot like the sort() 
method—you have a choice of using the 
element’s compareTo() method, assuming 
the element type implemented the 
Comparable interface, OR you can use 
a custom Comparator that knows how 
to sort the elements in the set. To use a 
custom Comparator, you call the TreeSet 
constructor that takes a Comparator. 


class Book implements Comparable { 

String title; 
public Book(String t) { 

title = t; 

} 

public int compareTo(Object b) { 

Book book = (Book) b; 

return (title.compareTo(book.title)); 


public class BookCompare implements Comparator<Book> { 
public int compare(Book one. Book two) { 
return (one.title.compareTo(two.title)); 


class Test { 

public void go() { 

Book bl = new Book (''How Cats Work ”）； 

Book b2 = new Book (''Remix your Body ”）； 

Book b3 = new Book (''Finding Emo"); 

BookCompare bCompare = new BookCompare(); 
TreeSet<Book> tree = new TreeSet<Book>(bCompare); 

tree . add (new Book (''How Cats Work ”）； 
tree . add (new Book (''Finding Emo 〃）； 
tree . add (new Book (''Remix your Body ”）； 

System.out.println(tree); 
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WcVg seen Lists and Sets, wow well use a Map 

Lists and Sets are great, but sometimes a Map is the best collection (not Collection 
with a capital “C” 一 remember that Maps are part of Java collections but they don’t 
implement the Collection interface). 

Imagine you want a collection that acts like a property list, where you give it a name 
and it gives you back the value associated with that name. Although keys will often be 
Strings, they can be any Java object (or, through autoboxing, a primitive). 


value 





Ball3” “Ball4” 


Map 


Each element in a Map is actually 
TWO objects — a key and a value. 
You can have duplicate values, but 
NOT duplicate keys. 


Map example 

import java.util.* 


public class TestMap 


public static void main(String[] args) 





HashMap<S tring r Integer> scores = new HashMap<S tring r Integer >()； 


scores • put (''Kathy' 42); 
scores . put("Bert", 343); 
scores . putrskyler' 420); 


h i^-tcad o( addO, on„ nov 
It takes two airgumchts (key, value). 


ahd how o-f 


how o-r (iouvsc 


System, out .printIn (scores) ; <^/： 

System, out.println (scores • get ( '' Bert ’’））； 丁匕 "、 ，• , 

y lakes a k cy； a ,d 

代七 wr hS the value this Usd / 


“sc, (h-tegev-). 


File Edit Window Help WhereAml 


% java TestMap 

{Skyler=420 , Bert=343, Kathy=42} 
343 


y° u ―七 lists ahd seis. 7 
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generic types 


Fmally.backto generics 

Remember earlier in the chapter we talked about how methods 
that take arguments with generic types can be... weird. And we 
mean weird in the polymorphic sense. If things start to feel 
strange here, just keep going — it takes a few pages to really tell 
the whole story. 

We’ll start with a reminder on how array arguments work, 
polymorphically, and then look at doing the same thing with 
generic lists. The code below compiles and runs without errors: 

Here’s how it works with regular arrays: 

import java.util.*; 


If a method argument is an array 
of Animals, it will also take an 
array of any Animal subtype. 

In other words, if a method is 
declared as: 

void foo(Animal[] a) {} 

Assuming Dog extends Animal, 
you are free to call both: 

foo(anAnimalArray); 



public class TestGenericsl { 

public static void main(String[] args) 
new TestGenericsl().go(); 


pcdav-c 3 v\d dvcsic dh avray, 


holds both dogs a^d 

public void go() { 

Animal[] animals = {new Dog(), new Cat(), new Dog()}; 

Dog[] dogs = {new Dog(), new Dog(), new Dog () }; 

takeAnimals (animals) ; Pcdlav-c dv-catc a av-v-ay, 

takeAnimals (dogs) ; Call "takcAhi^alsO, usih^ both that holds or>ly Poy (the dompilcv 

} "* a 八 ' 3 y types as av~gumcivts … let you put a Cat m)- 


public void takeAnimals (Animal [] animals) { 


for (Animal 
a.eat(); 


a : animals) { 


dhimdl，"the dhirvtd s ic rS 4 -Km A . i '' 

y J 47；； 

Uai a ^y ^ Md a，d C 』.r 仏 ？ 


Thm^ ia | poih + is 仏托七 iakcA^UO 


sih^c 


abstract class Animal { 
void eat() { 

System, out.println (''animal eating^); 


class Dog extends Animal { 
void bark() { } 

} 

class Cat extends Animal { 
void meow() { } 


Thc S — 1 心 d hic^uhy. 


568 





collections with generics 


Using polymorphic arguments and generics 

So we saw how the whole thing worked with arrays, but will it work 
the same way when we switch from an array to an ArrayList? Sounds 
reasonable, doesn’t it? 


First, let’s try it with only the Animal ArrayList. We made just a few 
changes to the go() method: 


Passing in just ArrayList<Animal> 


public void go() { 

ArrayList<Animal> animals 


animals.add(new Dog()); 
animals.add(new Cat ()); 
animals.add(new Dog()); 




^ lc 心。 … Ahi^ain to 
/WayLis"t<Ahimal>. 


new ArrayList<Animal> () 




takeAnimals (animals) 


"This is 七 he sdme todit) 
vav-iablc v-c-fcv-s io av\ 


how ihc 

nv"v-ayLis-t ihs-tc^d o-f avvay. 


public void takeAnimals (ArrayList<Animal> animals) { 


for(Animal a : animals) 
a.eat (); 


: how takes ah A^ayUsi 
cad o4 - ah array, bu-t cvcvy-thi h a 

-that -fov loop : 
wovks -Foir both avrays 扣 d C,o\\^ho, 


is 

x 


Compiles and runs just fine 


File Edit Window Help CatFoodlsBetter 


% java TestGenerics2 

animal eating 
animal eating 
animal eating 
animal eating 
animal eating 
animal eating 
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Put will it work with ArrayList<I?og> ? 


Because of polymorphism, the compiler let us pass a Dog array 
to a method with an Animal array argument. No problem. And 
an ArrayList<Animal> can be passed to a method with an 
ArrayList<Animal> argument. So the big question is, will the 
ArrayList<Animal> argument accept an ArrayList<Dog>? If it works 
with arrays, shouldn’t it work here too? 

Passing in just ArrayList<Dog> 

public void go() { 

ArrayList<Animal> animals = new ArrayList<Animal >()； 
animals.add(new Dog()); 
animals.add(new Cat ()); 
animals.add(new Dog()); 

takeAnimals (animals ); 卜 k^ow this li hC wovkcd ^ 

ArrayLis t<Dog> dogs = new ArrayList<Dog>(); 

dogs . add (new Dog ()); t\ A . 

dogs • add (new Dog () ) ; ^yLis-t ahd pu-t a Couple dogs ih. 

takeAnimals (dogs) ; t ^ ^ 赠 k 咖細 ^ ^ 

士浐 。咖 如 ainray to av\ A^ayUsi? 

public void takeAnimals (ArrayList<Animal> animals) { 

for(Animal a : animals) { 

a.eat (); 


When we compile it: 


File Edit Window Help CatsAreSmarter 


% java TestGenerics3 


TestGenerics3.java:21 : takeAnimals(java.util. 
ArrayList<Animal>) in TestGenerics3 cannot be applied to 
(java.util.ArrayList<Dog>) 
takeAnimals(dogs); 


I 七 looked so 

wch*t so wvohQ. 


error 
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And Tm supposed to be OK with this? That 
totally screws my animal simulation where the 
veterinary program takes a list of any type of 
animal, so that a dog kennel can send a list of dogs, 
and a cat kennel can send a list of cats... now 
you re saying I can’t do that if I use collections 
instead of arrays? 



What could happen if it were allowed... 

Imagine the compiler let you get away with that. It let you pass an 
ArrayList<Dog> to a method declared as: 

public void takeAnimals (Ar , ra.yList<Aniina.l> animals) 
for(Animal a : animals) { 

a.eat(); 


There’s nothing in that method that looks harmful, right? After all, 
the whole point of polymorphism is that anything an Animal can 
do (in this case, the eat() method), a Dog can do as well. So what’s 
the problem with having the method call eat() on each of the Dog 
references? 

Nothing. Nothing at all. 

There’s nothing wrong with that code. But imagine this code instead: 


public void takeAnimals (Ar , r , a.yList<Aniina.l> animals) { 

} animals, add (new Cat());^ y ikcs // jwst sWk a Cai ih 

mi # 七 be a Dogs-ohly /WayL-is 七 . 


So that’s the problem. There’s certainly nothing wrong with adding a 
Cat to an ArrayList<Animal>, and that’s the whole point of having an 
ArrayList of a supertype like Animal — so that you can put all types of 
animals in a single Animal ArrayList. 

But if you passed a Dog ArrayList — one meant to hold ONLY Dogs — 
to this method that takes an Animal ArrayList, then suddenly you’d 
end up with a Cat in the Dog list. The compiler knows that if it lets 
you pass a Dog ArrayList into the method like that, someone could, 
at runtime, add a Cat to your Dog list. So instead, the compiler just 
won’t let you take the risk. 

If you declare a method to take ArrayList<Animal> it can take ONLY an 
ArrayList<Animal>, not ArrayList<Dog> or ArrayList<Cat>. 
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arrays vs. ArrayLists 


Wait a minute... if this is why they woiVt let 
you pass a Dog ArrayList into a method that 
takes an Animal ArrayList—to stop you from 
possibly putting a Cat in what was actually a Dog list, 
then why does it work with arrays? Don’t you have 
the same problem with arrays? Can’t you still add 
a Cat object to a Dog[] ? 



Array types are checked again at 
runtime, but collection type checks 
happen only when you compile 

Let’s say you do add a Cat to an array declared as Dog[] (an array that 
was passed into a method argument declared as Animal[]，which is a 
perfectly legal assignment for arrays). 

public void go() { 

Dog[] dogs = {new Dog(>, new Dog(>, new Dog()}; 
takeAnimals(dogs); 

} 

public void takeAnimals(Animal[] animals) { 
animals[0] = new Cat(); 

} pu*t b hew Ca*t m*to a Dog avvay. The 

dompilev dllov/ed because i-t k^ov/s 
you have fussed a Ca 七 avvay ov /Wi 眯 al 

oivvay *to r^c*thod, so *to i*t 

y/3s possible 七 his y/3s 0^- 


It compiles, but when we run 


l/Vhcv// At least the 
vV/W stopped ii 


File Edit Window Help CatsAreSmarter 


% java TestGenericsl ~~ 

Exception in thread 、 'main 〃 java. lairaTArraystoreException : 

Cat ^ - 

at TestGenericsl. takeAnimals (TestGenericsl. java: 16) 
at TestGenericsl.go(TestGenericsl.java:12) 
at TestGenericsl.main(TestGenericsl.java:5) 
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collections with generics 



Wouldn’t it be dreamy if there were 
a way to still use polymorphic collection 
types as method arguments, so that my 
veterinary program could take Dog lists 
and Cat lists? That way I could loop through 
the lists and call their immunize() method, 
but it would still have to be safe so that you 
couldiVt add a Cat in to the Dog list. But I 
guess thafs just a fantasy... 
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generic wildcards 

Wildcards to the rescue 


It looks unusual, but there is a way to create a method argument that 
can accept an ArrayList of any Animal subtype. The simplest way is to 
use a wildcard — added to the Java language explicitly for this reason. 


public void takeAnimals (Ar , ra.yList<? extends Animal> animals) { 


for(Animal a : animals) { 

a.eat (); 


So now you’re wondering, “What’s the difference} Don’t you have 
the same problem as before? The method above isn’t doing 
anything dangerous — calling a method any Animal subtype is 
guaranteed to have — but can’t someone still change this to add a 
Cat to the animals list, even though it’s really an ArrayList<Dog>? 
And since it’s not checked again at runtime, how is this any 
different from declaring it without the wildcard?” 

And you’d be right for wondering. The answer is NO. When you 
use the wildcard <?> in your declaration, the compiler won’t let 
you do anything that adds to the list! 



Rcmcmbcv, *thc kcyy/ovd w oc*tchds w 

heve ciihcv OR 

implemgh-U dcpchdmg ov\ 

•type. So i-f you y/3h*t *to -take 
Sr\ A^^3yLis*t o-f -types 七 ha 七 

ihc Pc*t miev-fade, 

you’d dedave i*t as: 

Av-vayLis-t<? c^-tchds Pc*t> 


When you use a wildcard in your method 
argument, the compiler will STOP you from doing 
anything that could hurt the list referenced by the 
method parameter. 

You can still invoke methods on the elements in 
the list, but you cannot add elements to the list. 

In other words, you can do things with the list 
elements, but you can’t put new things in the list. 
So you’re safe at runtime, because the compiler 
won’t let you do anything that might be horrible at 
runtime. 

So, this is OK inside takeAnimals(): 

for(Animal a : animals) { 

a.eat(); 


But THIS would not compile: 

animals.add(new Cat()); 


574 




collections with generics 


Alternate syntax for domg the same thing 

You probably remember that when we looked at the sort() method, 
it used a generic type, but with an unusual format where the type 
parameter was declared before the return type. It’s just a different way 
of declaring the type parameter, but the results are the same: 


This: 

public <T extends Animal> void takeThing (ArrayList<T> list) 

Does the same thing as this: 

public void takeThing (ArrayList<? extends Animal> list) 


Dumb Questions 

If they both do the same thing, why would you use 
one over the other? 

A- 

It all depends on whether you want to use y/ T w some¬ 
where else. For example, what if you want the method to 
have two arguments — both of which are lists of a type that 
extend Animal? In that case, it’s more efficient to just declare 
the type parameter once: 

public <T extends Animal> void takeThing(ArrayList<T> one, ArrayList<T> two) 

Instead of typing: 


public void takeThing (Array Lis t<? extends Animal> one , 

ArrayList<? extends Animal> two) 
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be the compiler exercise 



BE th^ compiler, advanced 


Your job is to play compiler and determine which of 


魏 these statements would compile. But some of this 
code wasn’t covered in the chapter, so you need to 
，▼、 work out the answers based on what you DID learn, 
^ applying the "rules" to these new situations. In 
> some cases, you might have to guess, but the 

point is to come up with a reasonable answer 
based on what you know so far. 


(Note: assume that this code is within a legal class and 
method.) 


Compiles? 

ArrayList<Dog> dogsl = new ArrayList<Animal> (); 

ArrayList<Animal> animal si = new ArrayList<Dog>(); 

List<Animal> list = new ArrayList<Animal> (); 

ArrayList<Dog> dogs = new ArrayList<Dog> (); 

ArrayList<Animal> animals = dogs; 

List<Dog> dogList = dogs; 

ArrayList<Object> objects = new ArrayList<Object>(); 

List<Object> objList = objects; 

ArrayLis t<Obj ect> objs = new ArrayList<Dog>(); 
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collections with generics 


import java.util .*； 

public class SortMountains { 

LinkedList<Mountain> mtn = new LinkedList<Mountain> (); 


Solution ip ^ ‘ 货 verse 
Engineer” sKaifen exercise 


class Namecompare implements Comparator <Mountain> { 

public int compare(Mountain one , Mountain two) { 


return one.name.compareTo(two.name) 


class Heightcompare implements Comparator <Mountain> { 

public int compare(Mountain one. Mountain two) { 

return (two.height - one.height )； 




public static void main(String [] args) { 
new SortMountain().go(); 




public void go() { 

mtn.add(new Mountain("Longs ”， 
mtn.add(new Mountain("Elbert ”， 
mtn.add(new Mountain("Maroon", 
mtn.add(new Mountain("Castle ”， 


14255 )); 
14433 )); 
14156 )); 
14265 )); 


System.out.println("as entered:\n 〃 + mtn); 
NameCompare nc = new NameCompare(); 

Collections.sortCmtn, nc )； 

System.out .println( yy by name z\n r, + mtn); 
HeightCompare he = new Heightcompare(); 

Collections.sortCmtn, he )； 

System.out .println( yy by height :\n” + mtn); 


class Mountain { 

String name; 

int height ； 

Mountain(String r\ f int h) { 
name = n ； 
height = h ； 

} 

public String toString( ) { 
return name + •'•' + height ； 


Output: 

^N^^di^/vjndo\A^HeI^^TisOne^sForBob 


% java SortMountains 
as entered: 

[Longs 14255, Elbert 14433, Maroon 14156, Castle 14265] 
by name: 

[Castle 14265, Elbert 14433, Longs 14255, Maroon 14156] 
by height: 

[Elbert 14433, Castle 14265, Longs 14255, Maroon 14156] 
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fill-in-the-blank solution 


Exercise Solution 

Possible Answers: 

Comparator, 
Comparable, 
compareTo(), 
compare(), 
yes, 
no 


Given the following compilable statement: 

Collections.sort(myArrayList); 

1. What must the class of the objects stored in myArrayList implement? CofHpQPQblc 

2. What method must the class of the objects stored in myArrayList implement? COrnpQP6To() 

3. Can the class of the objects stored in myArrayList implement both 

Comparator AND Comparable? y6S 


Given the following compilable statement: 

Collections.sort(myArrayList, myCompare); 


4. Can the class of the objects stored in myArrayList implement Comparable? yes 


5. Can the class of the objects stored in myArrayList implement Comparator? yes 


6. Must the class of the objects stored in myArrayList implement Comparable? HO 


7. Must the class of the objects stored in myArrayList implement Comparator?^ HO 

8. What must the class of the myCompare object implement? CoiT^pQPQtOP 

9. What method must the class of the myCompare object implement? C0IDpQP6() 
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collections with generics 



BE th^ compiler solution 


Compiles? 


M 


□ 
運 f 

M 


ArrayList<Dog> dogsl = new ArrayList<Animal>(); 


ArrayList<Animal> animalsi = new ArrayList<Dog>(); 


List<Animal> list = new ArrayList<Animal> (); 


ArrayList<Dog> dogs = new ArrayList<Dog>(); 


ArrayList<Animal> animals = dogs; 


List<Dog> dogList = dogs; 


ArrayList<Object> objects = new ArrayList<Object>(); 


List<Object> objList = objects; 


ArrayLis t<Obj ect> objs = new ArrayList<Dog>(); 
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17 package, jars and deployment 


Release Your Code 



It’s time to let go. You wrote your code. You tested your code. You refined your code. 
You told everyone you know that if you never saw a line of code again, that’d be fine. But in the 
end, you’ve created a work of art. The thing actually runs! But now what? How do you give it to 
end users? What exactly do you give to end users? What if you don’t even know who your end 


users are? In these final two chapters, we’ll explore how to organize, package, and deploy your 
Java code. We’ll look at local, semi-local, and remote deployment options including executable 
jars, Java Web Start, RMI, and Servlets. In this chapter, we’ll spend most of our time on organizing 
and packaging your code — things you’ll need to know regardless of your ultimate deployment 
choice. In the final chapter, we’ll finish with one of the coolest things you can do in Java. Relax. 
Releasing your code is not saying goodbye.There’s always maintenance... 
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Java deployment 


Peploymg your application 


What exactly is a Java application? In other words, 
once you’re done with development, what is it that you 
deliver? Chances are, your end-users don’t have a system 
identical to yours. More importantly, they don’t have your 
application. So now it’s time to get your program in shape 
for deployment into The Outside World. In this chapter, 
we’ll look at local deployments, including Executable Jars 
and the part-local/part-remote technology called Java Web 
Start. In the next chapter, we’ll look at the more remote 
deployment options, including RMI and Servlets. 

Deployment options 


A Java program is a bunch 
of classes. That’s 也 e 
output of your development. 


The real question is whai 
to do widi 也 ose classes 


File Edit View 

o 


Executable 

Jar 


i File Edit View 


| 

一 

HTTP 


Web Start 


I File Edit View I 

Oh 

RMI app 


HTTP 

Servlets 


wiien you're done. 


100% Local Combination 100% Remote 


① Local 

The entire application runs on the 
end-users computer, as a stand-alone, 
probably GUI, program, deployed as 
an executable JAR (well look at JAR 
in a few pages.) 

② Combination of local and remote 

The application is distributed with a 
client portion running on the users 
local system, connected to a server 
where other parts of the application 
are running. 

③ Remote 

The entire Java application runs on a 
server system, with the client accessing 
the system through some non-Java 
means, probably a web browser. 



What are the advantages and 
disadvantages of delivering your 
Java program as a local, stand¬ 
alone application running on 
the end-user’s computer? 


What are the advantages and 
disadvantages of delivering your 
Java program as web-based 
system where the user interacts 
with a web browser, and the 
Java code runs as servlets on the 
server? 


But before we really get into the whole deployment thing, 
let’s take a step back and look at what happens when you’ve 
finished programming your app and you simply want to pull 
out the class files to give them to an end-user. What’s really 
in that working directory? 
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package, jars and deployment 



Imagine this scenario... 



Bob’s happily at work on the final pieces of his cool new 
Java program. After weeks of being in the “I’m^just- 
one-compile-away” mode, this time he’s really 
done. The program is a fairly sophisticated 
GUI app, but since the bulk of it is Swing 
code, he’s made only nine classes of his 
own. 


At last, it’s time to deliver the program to the 
client. He figures all he has to do is copy the 
nine class files, since the client already has 
the Java API installed. He starts by doing an 
Is on the directory where all his files are... 



Whoa! Something strange has happened. Instead of 18 
files (nine source code files and nine compiled class 
files), he sees 31 files, many of which have very strange 
names like: 



Account$FileListener.class 


Chart$Save Listener, class 


and on it goes. He had completely forgotten 
that the compiler has to generate class files 
for all those inner class GUI event listeners 
he made, and that’s what all the strangely- 
named classes are. 


Now he has to carefully extract all the class 
files he needs. If he leaves even one of them out, 
his program won’t work. But it’s tricky since he 
doesn’t want to accidentally send the client 
one of his source code files, yet everything is 
in the same directory in one big mess. 
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organizing your classes 


Separate source code and class files 

A single directory with a pile of source code and class files is a 
mess. It turns out, Bob should have been organizing his files 
from the beginning, keeping the source code and compiled 
code separate. In other words, making sure his compiled class 
files didn’t land in the same directory as his source code. 

The key is a combination of directory structure organization and the 
-d compiler option. 

There are dozens of ways you can organize your files, and your 
company might have a specific way they want you to do it. We 
recommend an organizational scheme that’s become almost 
standard, though. 

With this scheme, you create a project directory, and inside 
that you create a directory called source and a directory called 
classes. You start by saving your source code (.java files) into 
the source directory. Then the trick is to compile your code 
in such a way that the output (the .class files) ends up in the 
classes directory. 

And there’s a nice compiler flag, 一 d，that lets you do that. 


But I thought I didiVt have 
a choice about putting the class 
files in with the source files. 
When you compile, they just go 
there, so what do I do? 



Compiling with the -d (directory) flag 


%cd MyProject/source 
% javac -d ../classes 




the 


心 " S 卜 ^pilcv- io pu-t 

S" ㉗ 士 y 

， s f fer 

t woirki h9 d^ciory. 


MyApp.java 

l\\t ho 6 。十 c 


6ow—d 


By using the -d flag, you get to decide which directory the 
compiled code lands in, rather than accepting the default of 
class files landing in the same directory as the source code. 
To compile all the .java files in the source directory, use: 

% javac -d ../classes *.j ava 

氺 .java townies 
souvtc -f iles m 


r Uh y°^ ^i h 0 


Running your code 

%cd MyProject/classes 
% java Mini ^ 


souvtc 
tuwc 矜七 d*»v-c^*tovY 


MyApp.class 


vow 


丁 directory 
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101101 


iure e 

101010w w 


tat vej.w 

1010 10 0 


conse 

01010 1 


eugueroLore 

1010101 


do eliquis 

10101010 

1001010101 


do del dip 


MyApp.java 




my. 


f-tiroublcsliootihj hoic ： ewy 七 U3 ih this dhapieir assumes iKc 
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package, jars and deployment 


Put your Java m a JAR 



AJAR file is a Java ARchive. It’s based on the pkzip file format, and it lets you bundle 
all your classes so that instead of presenting your client with 28 class files, you hand 
over just a single JAR file. If you’re familiar with the tar command on UNIX, you’ll 
recognize the jar tool commands. (Note: when we say JAR in all caps, we’re referring 
to the archive file. When we use lowercase, we’re referring to the jar tool you use to 
create JAR files.) 

The question is, what does the client do with the JAR? How do you get it to run? 

You make the JAR executable. 

An executable JAR means the end-user doesn’t have to pull the class files out before 
running the program. The user can run the app while the class files are still in the 
JAR. The trick is to create a manifest file, that goes in the JAR and holds information 
about the files in the JAR. To make a JAR executable, the manifest must tell the JVM 
which class has the main() method! 


Making an executable JAR 

① Make sure all of your class files are in 
卞 he classes directory 

Were going to refine this in a few pages, but 
for now, keep all your class files sitting in the 
directory named classes*. 



101101 

1C 
1C 

0] 


101101 
101101 
10： 


T> 


101101 
101101 

101010_ 

1010 10 0 
01010 1 
1010101 
10101010 
1001010101 


1 


MyApp.class 


Create a manifest.txt file that states 
which class has the main() method 

Make a text file named manifest.txt that has a 

one line ： , l4 , 

( W 七？釓如.山 ss 

Main-Class : MyApp ^ 

Press the return key after typing the Main- 
Class line, or your manifest may not work 
correctly. Put the manifest file into the ''classes" 
directory. 


③ Run the jar tool to create a JAR file 
that contains everything in the classes 
directory, plus the manifest. 

%cd MiniProject/classes 

% jar -cvmf manifest.txt appl.jar *.class 
OR 

% jar -cvmf manifest.txt appl.jar MyApp.class 


Main-Class: L 






manifest.txt 



classes IV. 



manifest.txt 



朽 。 souvdc 

todt ( . 、 ava) 
•m 七 k 


app 1 . jar 
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executable JAR 



±\J\J iO UVUUI 


Combination 


100% Remote 


Most loo% local Java 
apps are deployed as 
executable JAR files. 


Runnmg (executing) the JAR 


Java (the JVM) is capable of loading a class from a JAR, and calling 
the main() method of that class. In fact, the entire application can 
stay in the JAR. Once the ball is rolling (i.e.，the main () method 
starts running), the JVM doesn’t care where your classes come 
from, as long as it can find them. And one of the places the JVM 
looks is within any JAR files in the classpath. If it can see a JAR, the 
JVM will look in that JAR when it needs to find and load a class. 



nc J\/M V^as io "sec 
,S -to make 70UV Y/oyrk •士 Wto” 


%cd MyProject/classes 


匕 - - 


v/V^cv-c *tV^c v)A^ ,s - 



appl.jar 



%j 


-jar appl.jar 


The 






a 

a ^l^ss. 




OAR ^ or 

t “A 心 r" 々 


Depending on how your operating system is configured, you 
might even be able to simply double-click the JAR file to launch 
it. This works on most flavors of Windows, and Mac OS X. You 
can usually make this happen by selecting the JAR and telling 
the OS to “Open with."” (or whatever the equivalent is on your 
operating system). 


^JiereiqrejiP 

Dumb Questions 


Why can’t ■ just JAR up an entire directory? 

The JVM looks inside the JAR and expects to find 
what it needs right there. It won’t go digging into other 
directories, unless the class is part of a package, and even 
then the JVM looks only in the directories that match the 
package statement? 


What did you just say? 

- You can’t put your class files into some arbitrary 
directory and JAR them up that way. But if your classes 
belong to packages, you can JAR up the entire package 
directory structure. In fact,you must. We'll explain all this on 
the next page, so you can relax. 
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package, jars and deployment 


Put your classes m packages! 


So you’ve written some nicely reusable class files, and you’ve 
posted them in your internal development library for other 
programmers to use. While basking in the glow of having 
just delivered some of the (in your humble opinion) best 
examples of OO ever conceived, you get a phone call. A 
frantic one. Two of your classes have the same name as 
the classes Fred just delivered to the library. And all hell is 
breaking loose out there, as naming collisions and ambiguit 
bring development to its knees. 

And all because you didn’t use packages! Well, you did use 
packages, in the sense of using classes in the Java API that are, 
of course, in packages. But you didn’t put your own classes 
into packages, and in the Real World, that’s Really Bad. 

We’re going to modify the organizational structure from the 
previous pages, just a little, to put classes into a package, and 
to JAR the entire package. Pay very close attention to the 
subtle and picky details. Even the tiniest deviation can stop 
your code from compiling and/or running. 

Packages prevent class name conflicts 



Package structure of the Java API for ： 

java.text.NumberFormat 

java.util.ArrayList 

java.awt.FlowLayout 

java.awt.event.ActionEvent 

java.net.Socket 


Although packages aren’t just for preventing name collisions, 
that’s a key feature. You might write a class named Customer 
and a class named Account and a class named ShoppingCart. 
And what do you know, half of all developers working in 
enterprise e-commerce have probably written classes with 
those names. In an OO world, that’s just dangerous. If part of 
the point of OO is to write reusable components, developers 
need to be able to piece together components from a 
variety of sources, and build something new out of them. 

Your components have to be able to ‘play well with others ’， 
including those you didn’t write or even know about. 

Remember way back in chapter 6 when we discussed how 
a package name is like the full name of a class, technically 
known as the fully-qualified name. Class ArrayList is really 
java. util.ArrayList, JButton is re ally javax. swing.JButton, and 
Socket is re ally java. net. Socket. Notice that two of those classes, 
ArrayList and Socket, both have java as their “first name”. 

In other words, the first part of their fully-qualified names 
is “java”. Think of a hierarchy when you think of package 
structures, and organize your classes accordingly. 


java 



Action Event 


What does this picture look like to 
you? Doesn't it look a whole lot like 
a directory hierarchy? 
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package naming 



PrcvGwtmg package name conflicts 

Putting your class in a package reduces the chances of naming 
conflicts with other classes, but what’s to stop two programmers 
from coming up with identical package names? In other words, 
what’s to stop two programmers, each with a class named Account, 
from putting the class in a package named shopping-customers? 
Both classes, in that case, would still have the same name: 

shopping, customers. Account 

Sun strongly suggests a package naming convention that greatly 
reduces that risk — prepend every class with your reverse domain 
name. Remember, domain names are guaranteed to be unique. 
Two different guys can be named Bartholomew Simpson, but two 
different domains cannot be named doh.com. 


Packages can prevent name 
conflicts, but only if you 
choose a package mm 
fiat's guaranteed to he 
unique. The best way to 
do 也 at is to preface your 
packages widi your reverse 
domain name. 


com.headfirstbooks.Book 




t\^ sS 




Reverse domain package names ^ 

com.headfirstjava.projects.Chart 
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package, jars and deployment 


③ Set up a matching directory structure 

Ifs not enough to say your class is in a package, 
by merely putting a package statement in 
the code. Your class Isn't truly in a package 
until you put the class in a matching directory 
structure. So, if the fully-qualified class name 
is com.headfirstjava.PackageExercise, you 
must put the PackageExercise source code in a 
directory named headfirstjava, which must be in 
a directory named com. 

It is possible to compile without doing that, but 
trust us—ifs not worth the other problems 
you’ll have. Keep your source code in a directory 
structure that matches the package structure, 
and you’ll avoid a ton of painful headaches down 
the road. 
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PackageExercise.class 


PackageExercise.java 


Set up a matching directory structure for 
both the source and classes trees. 


To put your class in a package: 

① Choose a package name 

Were using com.headfirstjava as our 
example. The class name is PackageExercise, 
so the fully-qualified name of the class is now ： 

com. headfirstjava. PackageExercise. 


② Put a package statement in your class 

It must be the first statement in the source 
code file, above any import statements. There 
can be only one package statement per source 
code file, so all classes in a source file must 
be in the same package. That includes inner 
classes, of course. 



package com.headfirstjava; 

import javax.swing.*; 

public class PackageExercise { 
// life-altering code here 


You must put a class 
into a directory 
structure that matches 
the package hierarchy. 


3 Jn4-unJ4-s 36D>l o Dd 
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compile and run with packages 

Compilmg and running with packages 

When your class is in a package, it’s a little trickier to compile and 
run. The main issue is that both the compiler and JVM have to be 
capable of finding your class and all of the other classes it uses. 
For the classes in the core API, that’s never a problem. Java always 
knows where its own stuff is. But for your classes, the solution 
of compiling from the same directory where the source files are 
simply won’t work (or at least not reliably). We guarantee, though, 
that if you follow the structure we describe on this page, you’ll be 
successful. There are other ways to do it, but this is the one we’ve 
found the most reliable and the easiest to stick to. 


Compiling with the -d (directory) flag 


%cd MyProject/source 




% javac -d ../classes com/headfirstjava/PackageExercise.java 






ou II still to— 
vow 


To compile all the .java files in the com.headfirstjava 
package, use: 


% javac -d ../classes 


Running your code 

%cd MyProject/classes 


com/headfirst java/*. java 


java com.headfirstjava.PackageExercise 

^ will 


y 
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PackageExercise.class PackageExercise.java 
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The -d flag is even cooler thaw we said 

Compiling with the -d flag is wonderful because not only does it 
let you send your compiled class files into a directory other than 
the one where the source file is，but it also knows to put the class 
into the correct directory structure for the package the class is in. 

But it gets even better! 

Let’s say that you have a nice 
directory structure all set up for your 
source code. But you haven’t set 
up a matching directory structure 
for your classes directory. Not a 
problem! Compiling with 
-d tells the compiler to not 
just put your classes into 
correct directory tree, but to 
the directories if they don’t 


l-f patkay 
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PackageExercise.java 


The -d flag tells the compiler ， 
“Put the class into its package 
directory structure, using the 
class specified after the -d as 
the root directory. But... if the 
directories aren’t there, create 
them first and then put the class 
in the right place!” 
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I tried to cd into the 
directory where my main class 
was, but now the JVM says it can’t 
find my class! But it，s right THERE 
in the current directory! 

A. 

Jr \* Once your class is in a 
package, you can’t call it by its 
'short'name. You MUST specify, 
at the command-line, the fully- 
qualified name of the class whose 
main() method you want to run. 
But since the fully-qualified name 
includes the package structure, 
Java insists that the class be in a 
matching directory structure. So if 
at the command-line you say: 

% java com.foo.Book 

the JVM will look in its current 
directory (and the rest of its 
classpath), for a directory named 
"com': /f will not look for a class 
named Book, until it has found 
a directory named "com" with a 
directory inside named "foo" Only 
then will the JVM accept that its 
found the correct Book class. If it 
finds a Book class anywhere else, 
it assumes the class isn’t in the 
right structure, even if it is! The 
JVM won’t for example, look back 
up the directory tree to say,"Oh, I 
can see that above us is a directory 
named com, so this must be the 
right package...” 
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JARs and packages 


Making an executable JAR with packages 



When your class is in a package, the package directory structure 
must be inside the JAR! You can’t just pop your classes in the 
JAR the way we did pre-packages. And you must be sure that you 
don’t include any other directories above your package. The 
first directory of your package (usually com) must be the first 
directory within the JAR! If you were to accidentally include the 
directory above the package (e.g. the “classes” directory), the JAR 
wouldn’t work correctly. 


Making an executable JAR 

① Moke sure all of your class files are 
within the correct package structure, 
under the classes directory. 


② Create a manifest.txt file that states 
which class has the main() method, 
and be sure to use the fully-qualified 
class name! 

Make a text file named manifest.txt that has a 
single line ： 

Main-Class : com.headfirstjava.PackageExercise 
Put the manifest file into the classes directory 
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③ 


Run the jar tool to create a JAR file 
that contains the package directories 
plus the manifest 


The only thing you need to include is the com* 
directory, and the entire package (and all classes) 
will go into the JAR. 




%cd MyProject/classes 
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% jar -cvmf manifest.txt packEx.jar 


com 


PackageExercise.class 
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So where did the manifest file go? 


Why don’t we look inside the JAR and find out? From the 
command-line, the jar tool can do more than just create and run a 
JAR. You can extract the contents of a JAR (just like ‘unzipping’ or 
‘un tarring’）. 




a 


Imagine you’ve put the packEx.jar into a directory named Skyler. 

jar commands for listing and extracting 



① List the contents of a JAR 


% jar -tf packEx.jar 



-t-P 




撕 f ile" 


File Edit Window Help Pickle 


% cd Skyler 

% jar -tf packEx.jar 

META-INF/ 

META-INF/MANIFEST.MF 
com/ 

com/headfirstjava/ 
com/headfirstjava/ 
PackageExercise.class 


② Extract the contents of a JAR (i.e. unjar) 

% cd Skyler 
% jar 


-xf 


packEx.jar 


-J stands ^ov- K Ubrati Ht av>d \i 
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MANIFEST.MF 
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META-INF stands for 'meta 
information 1 . The jar tool creates 
the META-INF directory as 
well as the MANIFEST.MF file. 
It also takes the contents of 
your manifest file, and puts it 
into the MANIFEST.MF file. So, 
your manifest file doesn't go into 
the JAR, but the contents of it 
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are put into the real 1 manifest 
(MANIFEST.MF). 
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organizing your classes 


Iharpen your pencil 



manifest.txt 


javaranch 


cows 
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Foof.class 


Foof.java 


Given the package/directory structure in this 
picture, figure out what you should type at the 
command-line to compile, run, create a JAR, and 
execute a JAR. Assume we’re using the standard 
where the package directory structure starts just 
below source and dosses. In other words, the source 
and dosses directories are not part of the package. 


Compile ： 

%cd source 
% javac _ 

Run ： 

%cd _ 

% java _ 

Create a JAR 

%cd _ 

% 


Execute a JAR 

%cd _ 

% 


Bonus question: What's wrong with the package name? 
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Dumb Questions 

What happens if you try 
to run an executable JAR, and 
the end-user doesn't have java 
installed? 

Nothing will run, since 
without a JVM, Java code can’t 
run.The end-user must have Java 
installed. 

How can I get Java 
installed on the end-user’s 
machine? 

Ideally, you can create a custom 
installer and distribute it along 
with your application. Several 
companies offer installer pro¬ 
grams ranging from simple to 
extremely powerful. An installer 
program could, for example, de¬ 
tect whether or not the end-user 
has an appropropriate version 
of Java installed, and if not, 
install and configure Java before 
installing your application. 
Installshield, InstallAnywhere, 
and DeployDirector all offer Java 
installer solutions. 

Another cool thing about some 
of the installer programs is that 
you can even make a deploy¬ 
ment CD-ROM that includes 
installers for all major Java 
platforms, so... one CD to rule 
them all. If the user’s running on 
Solaris, for example, the Solaris 
version of Java is installed. On 
Windows, the Windows, ver¬ 
sion, etc. If you have the budget, 
this is by far the easiest way for 
your end-users to get the right 
version of Java installed and 
configured. 


_BULLET POINTS _ 

■ Organize your project so that your source code and class files are not in 
the same directory. 

■ A standard organization structure is to create a project directory, and then 
put a source directory and a classes directory inside the project directory. 

■ Organizing your classes into packages prevents naming collisions with 
other classes, if you prepend your reverse domain name on to the front of 
a class name. 

■ To put a class in a package, put a package statement at the top of the 
source code file, before any import statements: 

package com.wickedlysmart; 

■ To be in a package, a class must be in a directory structure that exactly 
matches the package structure. For a class, com.wickedlysmart.Foo ， 
the Foo class must be in a directory named wickedlysmart, which is in a 
directory named com. 

■ To make your compiled class land in the correct package directory 
structure under the classes directory, use the -d compiler flag: 

% cd source 

% javac -d ../classes com/wickedlysmart/Foo.java 

■ To run your code, cd to the classes directory, and give the fully-qualified 
name of your class: 

% cd classes 

% java com.wickedlysmart.Foo 

■ You can bundle your classes into JAR (Java ARchive) files. JAR is based 
on the pkzip format. 

■ You can make an executable JAR file by putting a manifest into the JAR 
that states which class has the main() method. To create a manifest file, 
make a text file with an entry like the following (for example): 

Main-Class : com.wickedlysmart.Foo 

■ Be sure you hit the return key after typing the Main-Class line, or your 
manifest file may not work. 

■ To create a JAR file, type: 

jar -cvfm manifest.txt MyJar.jar com 

■ The entire package directory structure (and only the directories matching 
the package) must be immediately inside the JAR file. 

■ To run an executable JAR file, type: 

java -jar MyJar.jar 
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wouldn’t it be dreamy... 


Executable JAR files 
are nice, but wouldn’t it be dreamy 
if there were a way to make a rich, stand¬ 
alone client GUI that could be distributed 
over the Web? So that you wouldn’t have to 
press and distribute all those CD-ROMs. And 
wouldn’t it be just wonderful if the program 
could automatically update itself, replacing 
just the pieces that changed? The clients 
would always be up-to-date, and you'd never 
have to worry about delivering new 
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Java Web Start 

With Java Web Start (JWS), your application is launched for the 
first time from a Web browser (get it? Web Start?) but it runs as a 
stand-alone application (well, almost ), without the constraints of the 
browser. And once it’s downloaded to the end-user’s machine (which 
happens the first time the user accesses the browser link that starts 
the download), it stays there. 

Java Web Start is, among other things, a small Java program that lives 
on the client machine and works much like a browser plug-in (the 
way, say, Adobe Acrobat Reader opens when your browser gets a .pdf 
file). This Java program is called the Java Web Start ‘helper app ’， 
and its key purpose is to manage the downloading, updating, and 
launching (executing) of 3 ；owrJWS apps. 

When JWS downloads your application (an executable JAR), it 
invokes the main() method for your app. After that, the end-user can 
launch your application directory from the JWS helper app without 
having to go back through the Web page link. 

But that’s not the best part. The amazing thing about JWS is its 
ability to detect when even a small part of application (say, a single 
class file) has changed on the server, and — without any end-user 
intervention — download and integrate the updated code. 

There’s still an issue, of course, like how does the end-user 辦 Java 
and Java Web Start? They need both — Java to run the app, and Java 
Web Start (a small Java application itself) to handle retrieving and 
launching the app. But even that has been solved. You can set things 
up so that if your end-users don’t have JWS, they can download 
it from Sun. And if they do have JWS, but their version of Java is 
out-of-date (because you’ve specified in your JWS app that you 
need a specific version of Java), the Java 2 Standard Edition can be 
downloaded to the end-user machine. 

Best of all, it’s simple to use. You can serve up a JWS app much like 
any other type of Web resource such as a plain old HTML page or a 
JPEG image. You set up a Web (HTML) page with a link to your JWS 
application, and you’re in business. 

In the end, your JWS application isn’t much more than an 
executable JAR that end-users can download from the Web. 


End-users launcK a Java 
Meb Start by clicking 
on a link in a Web 
page. But onee 也 e 卿 
downloads, it runs outside 
也 e browser, just like any 
otiier stand-alone Java 
^plication. In fact, a 

Java Web Start 卿 is just 
an executable JAR fiat's 
distributed overlie Web. 
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How Java Web Start works 

① The client clicks on a Web page link 
to your JWS application (a .jnlp file). 

The Web page link 

<a href="MyApp•jnlp">Click</a> 
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② The Web server (HTTP) gets the 
request and sends back a .jnlp file 
(this is NOT the JAR). 

The .jnlp file is an XML document that 
states the name of the application’s 
executable JAR file. 



③ 


Java Web Start (a small ’helper app* 
on the client) is started up by the 
browser. The JWS helper app reads 
the .jnlp file, and asks the server for 
the My App. jar file. 


Java ^^3 矿七 



④ The Web server serves* up the 
requested .jar file. 




MyApp.jar 


⑤ 




HcllolVcbS-bir-t app ^ .LAP) 

Java Web Start gets the JAR and 
starts the application by calling the 
specified main() method (Just like an 
executable JAR). 

Next time the user wants to run this app, he can 
open the Java Web Start application and from 
there launch your app, without even being online. 
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The .jwlp file 


To make a Java Web Start app, you need to .jnlp (Java Network 
Launch Protocol) file that describes your application. This is the 
file the JWS app reads and uses to find your JAR and launch the 
app (by calling the JAR’s main() method). A .jnlp file is a simple 
XML document that has several different things you can put in, 
but as a minimum, it should look like this: 




<?xml version= 〃 l•0 〃 encoding= 〃 utf-8〃？> 


<jnlp spec= 〃 0•2 1.0 〃 




of 

w 己 ’ 
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hre f= ^MyApp.jnlp"> 


codebase=”http ://127 • 0 • 0 • 1 / 〜 kathy” , 

TL . . \ota {: \ov\ ^ vclatwc to t t 

nested *m some o 細 d\rtCio^ 


<information> 


<title>kathy App</title> 

<vendor>Wickedly Smart</vendor> 
Chomepage href="index.html"/> 


七 。 a - (Woadcd a 代 


y app 州吵七 
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<description>Head First WebStart demo</description> 


<icon href= 〃 kathys•gif〃/> 
<offline-allowed/> , TWlS 


</information> 




<resources> 


<j2se version="l• 3 +"/> 



TW.S says vouyr ^cds ws •咖 13 

Java, ov yea 七 cv. 


<jar href="MyApp. jar"/>^_ 7^ ^ 

</_ 之透迻 2 碟 


<application-desc main-class= 〃 HelloWebStart〃/> 
</jnlp> 


oir 
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Steps for making and deploying 
a Java Web Start app 


① 


Make an executable JAR 
for your application. 

MyApp.jar 



② 


Write a .jnlp file 
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MyApp.jnlp 


(D Place your JAR and .jnlp 
files on your Web server. 


Web Server 
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MyApp.jnlp MyApp.jar 


④ Add a new mime type to your Web server. 

application/x- j ava-j nip-file 

This causes the server to send the .jnlp file with the 
correct header, so that when the browser receives 
the .jnlp file it knows what it is and knows to start 
the JWS helper app. 


Web Server 


configure 
mime type 


(5) Create a Web page with a link 
to your .jnlp file 

<HTML> 
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MyJWSApp.html 


<BODY> 

<a href ="MyApp2 • jnlp’’>Launch My Application</a> 
</BODY> 

</HTML> 
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Look at the sequence of events below, and 2 

place them in the order in which they 
occur in a JWS application. 

3. 


Web browser starts up 
the JWS helper app 

the Web server sends 
file to the browser 


Web server sends a JAR 
ftle to the JWS helper app 


thtj ow^ 1 

the JAR ^ 


the JWS helper app invokes 
the JAR’s main() method 


user cli( 

rGQUuoio d .ji up mo 


from the Web server 


4. 

5. 

6 . 


^^tfcereiEirejiP 

Dumb Questions 

- How is Java Web Start different from an applet? 

A- 

Applets can't live outside of a Web browser. An applet is 
downloaded from the Web as part of a Web page rather than 
simply from a Web page. In other words, to the browser, the applet 
is just like a JPEG or any other resource.The browser uses either a 
Java plug-in or the browser’s own built-in Java (far less common 
today) to run the applet. Applets don’t have the same level of 
functionality for things such as automatic updating, and they must 
always be launched from the browser.With JWS applications, once 
they’re downloaded from the Web, the user doesn’t even have to 
be using a browser to relaunch the application locally. Instead, 
the user can start up the JWS helper app, and use it to launch the 
already-downloaded application again. 

- What are the security restrictions of JWS? 

A. 

Jr \* JWS apps have several limitations including being 
restricted from reading and writing to the user’s hard drive. But... 
JWS has its own API with a special open and save dialog box so 
that, with the user's permission, your app can save and read its 
own files in a special, restricted area of the user's drive. 


- BULLET POINTS - 

■ Java Web Start technology lets you deploy a 
stand-alone client application from the Web. 

■ Java Web Start includes a ‘helper app’ that must 
be installed on the client (along with Java). 

■ A Java Web Start (JWS) app has two pieces: 
an executable JAR and a .jnlp file. 

■ A .jnlp file is a simple XML document that 
describes your JWS application. It includes 
tags for specifying the name and location of the 
JAR, and the name of the class with the main() 
method. 

■ When a browser gets a .jnlp file from the server 
(because the user clicked on a link to the .jnlp 
file), the browser starts up the JWS helper app. 

■ The JWS helper app reads the .jnlp file and 
requests the executable JAR from the Web 
server. 

■ When the JWS gets the JAR, it invokes the 
main() method (specified in the .jnlp file). 
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exercise: True or False 



We explored packaging, deployment, and JWS 
in this chapter. Your job is to decide whether 
each of the following statements is true or false. 

ok FaLse^ 


1. The Java compiler has a flag, -d, that lets you decide where your .class files should go. 

2. AJAR is a standard directory where your .class files should reside. 

3. When creating a Java Archive you must create a file called jar.mf. 

4. The supporting file in a Java Archive declares which class has the main () method. 

5. JAR files must be unzipped before the JVM can use the classes inside. 

6. At the command line, Java Archives are invoked using the -arch flag. 

7. Package structures are meaningfully represented using hierarchies. 

8. Using your company’s domain name is not recommended when naming packages. 

9. Different classes within a source file can belong to different packages. 

10. When compiling classes in a package, the -p flag is highly recommended. 

11. When compiling classes in a package, the full name must mirror the directory tree. 

12. Judicious use of the -d flag can help to assure that there are no typos in your class tree. 

13. Extracting a JAR with packages will create a directory called meta-inf. 

14. Extracting a JAR with packages will create a file called manifest, mf. 

15. The JWS helper app always runs in conjunction with a browser. 

16. JWS applications require a .nip (Network Launch Protocol) file to work properly. 

17. AJWS’s main method is specified in its JAR file. 
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Anything in the book 
is fair game for this 
one! 


Across 


Down 



6. Won't travel 

26. Mine is unique 

1. Pushy widgets 

16. Who’s allowed 

30. I/O cleanup 

9. Don’t split me 

27. GUI's target 

2. of my desire 

19. Efficiency expert 

31. Milli-nap 

10. Release-able 

29. Java team 

3. 'Abandoned’moniker 

20. Early exit 

34. Trig method 

11. Got the key 

30. Factory 

4. A chunk 

21. Common wrapper 

36. Encaps method 

12. I/O gang 

32. For a while 

5. Math not trig 

23. Yes or no 

38. JNLP format 

15. Flatten 

33. Atomic *8 

6. Be brave 

24. Java jackets 

39. VB's final 

17. Encapsulated returner 

35. Good as new 

7. Arrange well 

26. Not behavior 

40. Java branch 

18. Ship this one 

37. Pairs event 

8. Swing slang 

28. Socket’s suite 


21. Make it so 

41. Where do 1 start 

11. I/O canals 



22. I/O sieve 

42. A little firewall 

13. Organized release 



25. Disk leaf 


14. Not for an instance 
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Exercise 

Solutions 


2 . 


3. 


4. 


5. 


6 . 




browser requests a .jnlp file 

from the Web server 


the Web server sends a .jnlp 
file to the browser 


the Web browser starts up 
the JWS helper app 

IJ^W^elper app 
the JAR 

jhe Web server sends a JAR 
file to the JWS helper app 

the JWS helper app invokes 
the JAR’s mainQ method 


1. The Java compiler has a flag, -d, that lets you decide where your .class files should go. 

2. AJAR is a standard directory where your .class files should reside. 

3. When creating a Java Archive you must create a file called jar,mf. 

4. The supporting file in a Java Archive declares which class has the main() method. 

5. JAR files must be unzipped before the JVM can use the classes inside. 

6. At the command line, Java Archives are invoked using the -arch flag. 

7. Package structures are meaningfully represented using hierarchies. 

8. Using your company’s domain name is not recommended when naming packages. 

9. Different classes within a source file can belong to different packages. 

10. When compiling classes in a package, the -p flag is highly recommended. 

11. When compiling classes in a package, the full name must mirror the directory tree. 

12. Judicious use of the -d flag can help to assure that there are no typos in your tree. 

13. Extracting a JAR with packages will create a directory called meta-inf. 

14. Extracting a JAR with packages will create a file called manifest, mf. 

15. The JWS helper app always runs in conjunction with a browser. 

16. JWS applications require a .nip (Network Launch Protocol) file to work properly. 

17. AJWS’s main method is specified in its JAR file. 


exercise solutions 





user clicks a Web page link 
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18 remote deployment with RMI 


Distributed 



Being remote doesn’t have to be a bad thing. Sure, things are easier when 

all the parts of your application are in one place, in one heap, with one JVM to rule them all. But 
that's not always possible. Or desirable. What if your application handles powerful computations. 


but the end-users are on a wimpy little Java-enabled device? What if your app needs data 
from a database, but for security reasons, only code on your server can access the database? 
Imagine a big e-commerce back-end, that has to run within a transaction-management system? 
Sometimes, part of your app must run on a server, while another part (usually a client) must 
run on a different machine. In this chapter, we’ll learn to use Java’s amazingly simple Remote 


Method Invocation (RMI) technology. We’ll also take a quick peek at Servlets, Enterprise Java 
Beans (EJB), and Jini, and look at the ways in which EJB and Jini depend on RMI. We'll end the 
book by writing one of the coolest things you can make in Java, a universal service browser. 
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how many heaps? 



File Edit View 




一 

HTTP 


Executable 

Jar 


Web Start 



100% Local 


Combina^ iu" 


±\J\J fO 


Remote 


Method calls are always between 
two objects oh the same heap. 

So far in this book, every method we’ve invoked has been on 
an object running in the same virtual machine as the caller. 
In other words, the calling object and the callee (the object 
we’re invoking the method on) live on the same heap. 

class Foo { 

void go () { 

Bar b = new Bar(); 
b. doStuff (); 

} 

public static void main (String[] args) { 
Foo f = new Foo(); 
f-go(); 

} 

} 

In the code above, we know that the Foo instance 
referenced by/and the Bar object referenced by b are 
both on the same heap, run by the same JVM. Remember, 
the JVM is responsible for stuffing bits into the reference 
variable that represent how to get to an object on the heap. 

The JVM always knows where each object is, and how to 
get to it. But the JVM can know about references on only 
its own heap! You can’t, for example, have a JVM running 
on one machine knowing about the heap space of a JVM 
running on a different In fact, a JVM running on 

one machine can’t know anything about a different JVM 
running on the sa 麗 machine. It makes no difference if 
the JVMs are on the same or different physical machines; 
it matters only that the two JVMs are, well, two different 
invocations of the JVM. 



^ Uo 




In most applications, when one object 
calls a method on another, both objects 
are on the same heap. In other words, 
both are running within the same JVM. 
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remote deployment witl RMI 


What if you want to invoke a method on 
an object running oh another machine? 


We know how to get information from one machine to another — 
with Sockets and 1/O. We open a Socket connection to another 
machine, and get an OutputStream and write some data to it. 


But what if we actually want to call a method on something running 
in another machine... another JVM? Of course we could always build 
our own protocol, and when you send data to a ServerSocket the 
server could parse it, figure out what you meant, do the work, and 
send back the result on another stream. What a pain, though. Think 
how much nicer it would be to just get a reference to the object on 
the other machine, and call a method. 




Imagine two computers... 




•Ohs 




Little 

Bigf kas sometking Little wants. 
Commute power. 


Little wants to send some data to Bigf, so tkat Big can do tke 
keavy computingf. 

Little wants simply to call a metliocL. 


double doCalcUsingDatabase(CalcNumbers numbers) 


and get Lack tke result. 


But kow can Little get a reference to an otject on Big? 


you are here ► 
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two objects, two heaps 


Object A, ruwwiwg ow Little, wants to call 
a method on Object R running on Pig. 

The question is, how do we get an object on one machine 
(which means a different heap/JVM) to call a method on 
another machine? 



doCalcUsingDatabaseQ . 


p 0 

-u 


return value 


■ ■ ^ 



Put you caw't do that. 


Well, not directly anyway. You can’t get a reference to 
something on another heap. If you say: 

Dog d = ??? 

Whatever d is referencing must be in the same heap space as 
the code running the statement. 

But imagine you want to design something that will use 
Sockets and I/O to communicate your intention (a method 
invocation on an object running on another machine), yet 
still feel as though you were making a local method call. 

In other words, you want to cause a method invocation on a 
remote object (i.e., an object in a heap somewhere else), but 
with code that lets you pretend that you’re invoking a method 
on a local object. The ease of a plain old everyday method 
call, but the power of remote method invocation. That’s our 
goal. 

That’s what RMI (Remote Method Invocation) gives you! 

But let’s step back and imagine how you would design RMI if 
you were doing it yourself. Understanding what you’d have to 
build yourself will help you learn how RMI works. 
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A design for remote method calls 


remote deployment witl RMI 


Create four things: server, client ， 
server helper，client helper 


① Create client and server apps. The server app is the 
remote service that has an object with the method 


that the client wants to invoke. 



Client heap 



② Create client and server 'helpers 1 . They 1 11 handle all 
the low-level networking and I/O details so your client 
and service can pretend like theyre in the same heap. 



Client heap 


a 
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client and server helpers 


The role of the "helpers' 

The ‘helpers’ are the objects that actually do the communicating. 
They make it possible for the client to act as though its calling a 
method on a local object. In fact, it is. The client calls a method on 
the client helper, as if the client helper were the actual service. The client 
helper is a proxy for the Real Thing. 

In other words, the client object thinks it’s calling a method on 
the remote service, because the client helper is pretending to be 
the service object. Pretending to be the thing with the method the client 
wants to call! 


But the client helper isn’t really the remote service. Although the 
client helper acts like it (because it has the same method that the 
service is advertising), the client helper doesn’t have any of the 
actual method logic the client is expecting. Instead, the client 
helper contacts the server, transfers information about the method 
call (e.g., name of the method, arguments, etc.), and waits for a 
return from the server. 


On the server side, the service helper receives the request from 
the client helper (through a Socket connection), unpacks the 
information about the call, and then invokes the real method on 
the real service object. So to the service object, the call is local. It’s 
coming from the service helper, not a remote client. 

The service helper gets the return value from the service, packs it 
up, and ships it back (over a Socket’s output stream) to the client 
helper. The client helper unpacks the information and returns the 
value to the client object. 


Your client object gets to 
act like it's making remote 


me^iod calls. But ^viat 
it’s really doing is calling 
me^iods on a he 冲 - local 
'prox/ object handles 
all 也 e low-level details of 
Sockets and streams. 







Client heap 


Real 


C 以匇兮 = 

Real I 七 

do ^ 


Server heap 


Scvvi 匕 c hclpcv gets the 

Request Won\ -the diehi 
^ lls the method oh ihc 


A 
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How the method call happens 


remote deployment witl RMI 


① 



Client object calls doBigThingQ on the client helper object 


O Client heap 


Server heap 


② 





Client heap « c|| . ent wants to" cal I a method ， 

doBigThingQ 


Server heap 


Client helper packages up information about the call 
(arguments, method name, etc.) and ships it over the 
network to the service helper. 


③ 



Service helper unpacks the information from the client helper, 
finds out which method to call (and on which object) and 
invokes th e rea l method on the real service object. 

□ Client heap « dient wants J CQ n Q method 〃 Server heap 
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RMI helper objects 


Java RMI gives you the client and 
service helper objects! 


In Java, RMI builds the client and service helper 
objects for you, and it even knows how to make the 
client helper look like the Real Service. In other 
words, RMI knows how to give the client helper 
object the same methods you want to call on the 
remote service. 

Plus, RMI provides all the runtime infrastructure to 
make it work, including a lookup service so that the 
client can find and get the client helper (the proxy 
for the Real Service). 

With RMI, you don’t write any of the networking 
or I/O code yourself. The client gets to call remote 
methods (i.e. the ones the Real Service has) just 
like normal method calls on objects running in the 
client’s own local JVM. 

Almost. 

There is one difference between RMI calls and local 
(normal) method calls. Remember that even though 
to the client it looks like the method call is local, 
the client helper sends the method call across the 
network. So there is networking and I/O. And what 
do we know about networking and I/O methods? 

They’re risky! 


They throw exceptions all over the place. 

So, the client does have to acknowledge the risk. The 
client has to acknowledge that when it calls a remote 
method, even though to the client it’s just a local call 
to the proxy/helper object, the call ultimately involves 
Sockets and streams. The client’s original call is local, 
but the proxy turns it into a remote call. A remote call 
just means a method that’s invoked on an object on 
another JVM. How the information about that call 
gets transferred from one JVM to another depends 
on the protocol used by the helper objects. 

With RMI, you have a choice of protocols: JRMP or 
HOP. JRMP is RMFs ‘native’ protocol, the one made 
just for Java-to-Java remote calls. HOP, on the other 
hand, is the protocol for CORBA (Common Object 
Request Broker Architecture), and lets you make 
remote calls on things which aren’t necessarily Java 
objects. CORBA is usually much more painful than 
RMI, because if you don’t have Java on both ends, 
there’s an awful lot of translation and conversion that 
has to happen. 

But thankfully, all we care about is Java-to-Java, so 
we’re sticking with plain old, remarkably easy RMI. 


In RMI, the client helper is a ^stub 9 
and the server helper is a ^skeleton 9 . 


614 



0 Client heap 


chapter 18 



Server heap 


















remote deployment witl RMI 


Making the Remote Service 

This is an overview of the five steps for making the remote 
service (that runs on the server). Don’t worry, each step is 
explained in detail over the next few pages. 


Server 






Step one: 

Make a Remote Interface 

The remote interface defines the methods 
that a client can call remotely. It’s what 
the client will use as the polymorphic class 
type for your service. Both the Stub and 
actual service will implement this! 





MyRemote.java 




Step two: 

Make a Remote Implementation 

This is the class that does the Real Work. 
It has the real implementation of the 
remote methods defined in the remote 


public inteii 
MyRemote 
Remote {} 






.TV.e Real Sev-Vde- T\^t\ass 

i\,t v-cal v/ork. 

4-Uf vcwotc mW-VadC. 


interface. It’s the object that the client 
wants to call methods on. 


Step three: 

Generate the stubs and skeletons using rmic 

These are the client and server ‘helpers’. 

You don’t have to create these classes or ever 
look at the source code that generates them. 
It’s all handled automatically when you 
run the rmic tool that ships with your Java 
development kit. 

Step four: 

Start the RMI registry (rmiregistry) 

The rmiregistry is like the white pages of a 
phone book. It’s where the user goes to get 
the proxy (the client stub/helper object). 






File Edit Window Help Eat 


% rmic My Remo te Impl 


1011 p 
10 i 

0 11 u 
001 10 
001 01 


MyRemotelmpLStub.class 


ion p 
10 1 
0 11 u 
001 10 
001 01 


MyRemotelmpLSkel.class 


File Edit Window Help Drink 


% rmiregistry 



Step five: 

Start the remote service 

You have to get the service object up and running. 
Your service implementation class instantiates an 
instance of the service and registers it with the RMI 
registry. Registering it makes the service available for 
clients. 


File Edit Window Help BeMerry 


% java MyRemote Impl 
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a remote interface 


Step one: Make a Remote Interface 



① Extend java.rmi.Remote 

Remote is a ‘marker’ interface, which means it has no methods. It has 
special meaning for RMI, though, so you must follow this rule. Notice 
that we say ‘extends’ here. One interface is allowed to extend another 
interface. 

public interface MyRemote extends Remote { 


MyRemote.java 


② Declare that all methods throw a RemoteException 

The remote interface is the one the client uses as the polymorphic type 
for the service. In other words, the client invokes methods on something 
that implements the remote interface. That something is the stub, of 
course, and since the stub is doing networking and 1/O, all kinds of Bad 
Things can happen. The client has to acknowledge the risks by handling 
or declaring the remote exceptions. If the methods in an interface 
declare exceptions, any code calling methods on a reference of that type 
(the interface type) must handle or declare the exceptions. 


Vo- 拉 

上 


import java • rmi . * ,• 4 — Remote m j a 

public interface MyRemote extends Remote { 

public String sayHello() throws RemoteException; 


method 匕 all is 

^ohsidcv-cd Visky. 
Kc^otcEx^cptioh Oh cvcvy 
: 钍 hod W« ihc dicht 
io P^y a-t-tch-tioh a^d 

a^khowlcdgc that -thii 
州吵七 ho "t wovk. 


— 


Be sure arguments and return values are primitives or Serializable 

Arguments and return values of a remote method must be either primitive 
or Serializable. Think about it. Any argument to a remote method has to 
be packaged up and shipped across the network, and that’s done through 
Serialization. Same thing with return values. If you use primitives, Strings, 
and the majority of types in the API (including arrays and collections), 
you’ll be fine. If you are passing around your own types, just be sure that 
you make your classes implement Serializable. 

public String sayHello() throws RemoteException; 

Th，S 士作 十 is aoma be shipped 

C 产卜 ^ 咖 d to 
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Step two: Make a Remote Implementation 

① Implement the Remote interface 


A 


public interl 
MyRemote 
Remote {} 


MyRemotelmpl.java 


Your service has to implement the remote interface — the one 
with the methods your client is going to call. 

public class MyRemoteImpl extends UnicastRemoteObject implements MyRemote { 

h 


public String sayHello() 
return ''Server says 


// more code in class 


,'Hey ， " ； 1 will make suve that 

} Q[A vc all the methods 

you —I 
this ohly ohc. 


② Extend UnicastRemoteObject 

In order to work as a remote service object, your object needs some 
functionality related to ‘being remote’. The simplest way is to extend 
UnicastRemoteObject (from the java.rmi.server package) and let that 
class (your superclass) do the work for you. 

public class MyRemo teImpl extends UnicastRemoteObject implements MyRemote { 


③ Write a no-arg constructor that declares a RemoteException 

Your new superclass, UnicastRemoteObject, has one little problem — its 
constructor throws a RemoteException. The only way to deal with this is 
to declare a constructor for your remote implementation, just so that you 
have a place to declare the RemoteException. Remember, when a class is 
instantiated, its superclass constructor is always called. If your superclass 
constructor throws an exception, you have no choice but to declare that 


your constructor also throws an exception. 


ft 




m 


public MyRemote Impl () throws RemoteException { } u i j 70^ SVA ?^ cld 

: ZiUor tWs a，W 


-to v>vaI 
r y 0 u just 


④ Register the service with the RMI registry 


Now that you’ve got a remote service, you have to make it available to 

remote clients. You do this by instantiating it and putting it into the RMI 

registry (which must be running or this line of code fails). When you 

register the implementation object, the RMI system actually puts the stub in 

the registry, since that’s what the client really needs. Register your service 

using the static rebind () method of the java.rmi.Naming class. n 

try { W 二却 ) “ wT£ 

MyRemote service = new MyRemote Impl () ; to \oo^ \ Ml 入 l vi ia/u^vx vou bma 

Naming. rebind (''Remote Hello 〃 

} catch(Exception ex) {...} 


service 
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stubs and skeletons 


Step three: generate stubs and skeletons 


① Run rmic on the remote implementation class 
(not the remote interface) 

The rmic tool, that comes with the Java software 
development kit, takes a service implementation and 
creates two new classes, the stub and the skeleton. 

It uses a naming convention that is the name of 
your remote implementation, with either _Stub or 
_Skeleton added to the end. There are other options 
with rmic, including not generating skeletons, 
seeing what the source code for these classes looked 
like, and even using HOP as the protocol. The way 
we’re doing it here is the way you’ll usually do it. 

The classes will land in the current directory (i.e. 
whatever you did a cd to). Remember, rmic must 
be able to see your implementation class, so you’ll 
probably run rmic from the directory where your 
remote implementation is. (We’re deliberately not 
using packages here, to make it simpler. In the Real 
World, you’ll need to account for package directory 
structures and fully-qualified names). 


Step four: run rmiregistry 

① Bring up a terminal and start the rmiregistry. 

Be sure you start it from a directory that has access 
to your classes. The simplest way is to start it from 
your ‘classes’ directory. 




OY\ 


w .dlass 


)) 





1011 

10 1 



0 11 

u 


001 

10 


001 

01 



MyRemotelmpLStub.class 


1011 


10 1 


0 11 u 


001 10 


001 01 



MyRemotelmpLSkel.class 


File Edit Window Help Huh? 


% rmiregistry 


Step five: start the service 


① Bring up another terminal and start your service 

This might be from a main () method in your remote 
implementation class, or from a separate launcher class. 
In this simple example, we put the starter code in the 
implementation class, in a main method that instantiates 
the object and registers it with RMI registry. 


File Edit Window Help Huh? 


% java MyRemoteImpl 
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Complete code for the server side 


remote deployment witl RMI 


The Remote interface: 


Server 



import java.rmi. 


Remo 七如矸 W “ 士 

arc m javarm, ?a^ay 

^~、\(。 你 MWST 

public interface My Remote extends Remote { ja\/a.vwi.Rcwo*tc 

All or Vou\r \rCrwotc rwethods rwus*t 

public String sayHello () throws RemoteException; dcdlavc d Rcrwo'tcBxdcp'tioh 


The Remote service (the implementation): 


vCtt' s 


\y\ 


import java.rmi.*; ^ 

import java.rmi.server.*; 




public class MyRemoteImpl extends UnicastRemoteObject implements MyRemote { 

public String sayHello () { ^ ^^ n 

return ''Server says, 'Hey ’"； 丄 . c ythods, o 4 * dou\rse . 队七 

} that you do HOT have io 

dcdlav-c the Kcrtno-ieB% 6 cphoy\. 


yo“ 峨 s 

^Crmoic 


SJt:〆 y， 


public MyRemoteImpl() throws RemoteException { } 


public static void main (String[] args) { 
try { 

MyRemote service = new MyRemoteImpl(); 
Naming. rebind (''Remote Hello", service) 
} catch(Exception ex) { 
ex.printstackTrace(); 


Vouv- superclass Cov\sbr\ACior (*fov 
L^sk^oitO\>^i) dedans a, so 

VOU must 一七 c a Co^bryAtior, because it 吣 
youv- Co^sbryAtior is ^allm^ v-isky todt its 

.tcmS'brud'tovO 


supcv- 


赛 Hi 總,^ 上 
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getting the stub 



How does the client get the stub object? 


The client has to get the stub object, since that’s the thing the 
client will call methods on. And that’s where the RMI registry 
comes in. The client does a ‘lookup’，like going to the white pages 
of a phone book, and essentially says, “Here’s a name, and I’d like 
the stub that goes with that name.” 


lookupO is B method o( 

dldss 


丁 "his nnusi 4 -Lm 

uhdev 




My Remote service = (My Remote) Naming. lookup (''rmi :/ /127.0.0.1/Remote Hello ’’）； 

\ 

丁 k 乙 licivt dlw^ys uses -the 
pmotc i^plcmch-b-tioh as th c 

u^ C I f hc scWlU ' ^ 

heeds to khow 

the adxual 匕 lass hdme c^f youv* 

^remoze - 


have *to ^as*t i*t to the 

m-tev-fade, s\Y\tt lookup 

method \rc*tu\nr\s -type Object 


you\r Si OV IP 
address joes hcv-c 


SCVVUlc. 


Client 


Server 


① Client does a lookup on the RMI registry 

Naming. lookup (''rmi : //127.0.0.1/Remote Hello"); 

(5) RMI registry returns the stub object 

(as the return value of the lookup method) and RMI 
deserializes the stub automatically. You MUST have 
the stub class (that rmic generated for you) on the 
client or the stub won’t be deserialized. 


RMI registry (on server) 



Remote 1 



w 1 

L Stub 



( 3 ) Client invokes a method on the stub, 
though the stub IS the real service 
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How does the client get the stub class? 


Now we get to the interesting question. Somehow, someway, the 
client must have the stub class (that you generated earlier using 
rmic) at the time the client does the lookup, or else the stub won’t 
be deserialized on the client and the whole thing blows up. In a 
simple system, you can simply hand-deliver the stub class to the 
client. 

There’s a much cooler way, though, although it’s beyond the 
scope of this book. But just in case you’re interested, the cooler 
way is called “dynamic class downloading”. With dynamic class 
downloading, a stub object (or really any Serialized object) is 
‘stamped’ with a URL that tells the RMI system on the client 
where to find the class file for that object. Then, in the process of 
deserializing an object, if RMI can’t find the class locally, it uses 
that URL to do an HTTP Get to retrieve the class file. So you’d 
need a simple Web server to serve up class files, and you’d also 
need to change some security parameters on the client. There are 
a few other tricky issues with dynamic class downloading, but that’s 
the overview. 


Complete client code 



public class MyRemoteClient { 

public static void main (String[] args) { 
new MyRemoteClient().go(); 




try { \L 

My Remote service = (MyRemote) Naming, lookup (''rmi : / /127.0.0.1/Remote Hello"); 



String s = service.sayHello(); 
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RMI class files 


te sure each machine has the class 
files it needs. 

The top three things programmers do wrong with RMI are: 

1) Forget to start rmiregistry before starting remote service 
(when you register the service using Naming.rebind(), the 
rmiregistry must be running!) 

2) Forget to make arguments and return types serializable 
(you won’t know until runtime; this is not something the 
compiler will detect.) 

3) Forget to give the stub class to the client. 


Don’t -fov-yt ； dieirrt 

uses the to dall 

methods oy \ the s*tub- The 
dieirrt vVM ^ccds the stub 
dlass, bu*b the die 灼 *t WV" 
v-c-fcv-s -to -the stub dass 
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Clientclass MyRemotelmpLStub.class 
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MyRemote.class 
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MyRemotelmpl.class MyRemotelmpLStub.class 
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MyRemotelmpLSkel.class 
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MyRemote.class 


Scv-vcv needs both the Stub Skeleton 
classes ； as well as -the sev-vite By\d the 
v-emote mtcv-fadc. It ^ccds the stub dlass 
because \rcmcmbcv-, the stub is substituted 
-fov \real sev-vite, the v-cal sev-vide 
is bou^d *to the R/l/|| v-ejistv-y. 


622 


chapter 18 



























remote deployment witl RMI 


q^krpen your pencil 




o 



Look at the sequence of events below, and 
place them in the order in which they 
occur in a Java RMI application. 


_ _ 

丁 RM1 re 9istry 


call to the server 

丁 he client does a look 
the RMI Registry 


The 

on the stub 


The remote service is regis¬ 
tered with the RMI registry 


The RU 


ot0 S&l V yi VI I 

implementation) is instantiated 


2 . 

3. 

4. 

5. 

6 . 


- BULLET POINTS - 

■ An object on one heap cannot get a normal Java 
reference to an object on a different heap (which means 
running on a different JVM) 

■ Java Remote Method Invocation (RMI) makes it seem like 
you’re calling a method on a remote object (i.e. an object 
in a different JVM), but you aren't. 

■ When a client calls a method on a remote object, the 
client is really calling a method on a proxy of the remote 
object. The proxy is called a ‘stub’. 

■ A stub is a client helper object that takes care of the low- 
level networking details (sockets, streams, serialization, 
etc.) by packaging and sending method calls to the 
server. 

■ To build a remote service (in other words, an object that 
a remote client can ultimately call methods on), you must 
start with a remote interface. 

■ A remote interface must extend the java.rmi.Remote 
interface, and all methods must declare 
RemoteException. 

■ Your remote service implements your remote interface. 


■ Your remote service should extend UnicastRemoteObject. 
(Technically there are other ways to create a remote ob¬ 
ject, but extending UnicastRemoteObject is the simplest). 

■ Your remote service class must have a constructor, 
and the constructor must declare a RemoteException 
(because the superclass constructor declares one). 

■ Your remote service must be instantiated, and the object 
registered with the RMI registry. 

■ To register a remote service, use the static 
Nanning.rebindfService Name", servicelnstance); 

■ The RMI registry must be running on the same machine 
as the remote service, before you try to register a remote 
object with the RMI registry. 

■ The client looks up your remote service using the static 
Naming.lookup(“rmi://MyHostName/ServiceName ’’)； 

■ Almost everything related to RMI can throw a 
RemoteException (checked by the compiler). This 
includes registering or looking up a service in the reigstry, 
and all remote method calls from the client to the stub. 
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uses for RMI 


Yeah, but who really uses RMI? 



Me too! How 
did anyone get 
by? I just love RMI 
for giving us Jini 
一 technology. t „ 


I just cant imagine <; 
life without our Jini- 
enabled home network 
and applicances. 




—■ We use it 
for our cool 
new decision-support 
system. 


I heard your ex- 
wife still uses 
plain sockets. 




- 


Weve got an 
EJB-based hotel 
reservation system. 
And EJB uses RMI! 


I use it 

for serious B-to-B, } 
e-commerce back¬ 
ends, running on J2EE 
^ technology. r 
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What about Servlets? 

Servlets are Java programs that run on (and with) an HTTP web server. When a client uses a 
web browser to interact with a web page, a request is sent back to the web server. If the request 
needs the help of a Java servlet, the web server runs (or calls, if the servlet is already running) 
the servlet code. Servlet code is simply code that runs on the server, to do work as a result of 
whatever the client requests (for example, save information to a text file or database on the 
server). If you’re familiar with CGI scripts written in Perl, you know exactly what we’re talking 
about. Web developers use CGI scripts or servlets to do everything from sending user-submitted 
info to a database, to running a web-site’s discussion board. 

And even servlets can use RMI! 

By far, the most common use of J2EE technology is to mix servlets and EJBs together, where 
servlets are the client of the EJB. And in that case, the servlet is using RMI to talk to the EJBs. 
(Although the way you use RMI with EJB is a little different from the process we just looked at.) 


① Client fills out a registration form and clicks 'submit*. 

The HTTP server (i.e. web server) gets the request, sees that 
it's for a servlet, and sends the request to the servlet. 


Web Browser 
(client) 


Web Server 


'client requests RegisterServlet 


[ 

I. |_bierra_^ 

1 lui ■ ■ I > 




② 


Servlet (Java code) runs, adds data to the database, 
composes a web page (with custom info) and sends it back to 
the client where it displays in the browser. 


Web Browser 

(client) ''client requests RegisterServlet 


Web Server 



u heres a confirmation page' 



confirm.html 
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very simple servlet 

Step for making and running a servlet 


① Find out where your servlets need to be placed. 

For these examples, we’ll assume that you already have a web server 
up and running, and that it’s already configured to support servlets. 
The most important thing is to find out exactly where your servlet 
class files have to be placed in order for your server to ‘see’ them. If 
you have a web site hosted by an ISP, the hosting service can tell you 
where to put your servlets, just as they’ll tell you where to place your 
CGI scripts. 



② Get the servlets.jar and add it to your classpath 

Servlets aren’t part of the standard Java libraries; you need 
the servlets classes packaged into the servlets .jar file. You can 
download the servlets classes fromjava.sun.com, or you can get 
them from your Java-enabled web server (like Apache Tomcat, at 
the apache.org site). Without these classes, you won’t be able to 
compile your servlets. 



servlets.jar 


(3) Write a servlet class by extending HttpServlet 

A servlet is just a Java class that extends HttpServlet (from the 
javax.servlet.http package). There are other types of servlets you 
can make, but most of the time we care only about HttpServlet. 

public class MyServletA extends HttpServlet { ••• 


1011 p 
10 1 
0 11 u 
001 10 
001 01 


MyServletA.class 


④ Write an HTML page that invokes your servlet 

When the user clicks a link that references your servlet, the web 
server will find the servlet and invoke the appropriate method 
depending on the HTTP command (GET, POST, etc.) 


<HTML> 
<BODY> 
Java 
rules! 

<BODY> 

<HTML> 


MyPage.html 


<a href="servlets/MyServletA">This is the most amazing servlet.</a> 


⑤ Make your servlet and HTML page available to your server 

This is completely dependent on your web server (and more specifi¬ 
cally, on which version of Java Servlets that you’re using). Your ISP 
may simply tell you to drop it into a “Servlets” directory on your 
web site. But if you’re using, say, the latest version of Tomcat, you’ll 
have a lot more work to do to get the servlet (and web page) into 
the right location. (We just happen to have a book on this too .) 


Web Server 
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A very simple Servlet 
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import java.io.*; 
import javax.servlet.*; ^ 
import j avax.servlet.http 




Mos*t Vov-mar scwlcis v/ill c>c*tcr>d 
public class MyServletA extends HttpServlet { H 七切 Sevvlrt, ⑶ ovemde oy>e or 

move methods. 

Overvide tV»e do^et ^ simple TV>e ^ sewev tails tWis w>et^o^ ^ Ves\>onse 

—.s prL A t^ y e (a 

public void doGet (HttpServletRequest request, HttpServletResponse response) 

throws ServletException, IOException { 



一 w». ^ S sc\rvc\r (av\d b\rowsc\r) what kihd o*f 

response. setContentType ( 、 'text/html’’> ; ,s 乙 orwihg bat\c Worn the sc^vc^ as a v-cusli of 

this soviet \ruhhihg. 


Y/vi-tc m-fovwat>o^ 

If you ' re reading this, it worked! 


PrintWriter out = response.getWriter() 
String message = 
out.println (''<HTMLXBODY> ,/ ); 


out.println(' 、 </BODYX/HTML >〃）； 
out.close(); 









tW»s stU. 


V^at web 


looks l\kc ： 


HTML page with a link to this servlet 


didk the Uk 

to \x\p^ 

scv-vlct 


<HTML> 

<BODY> 

<a href= 〃 servlets/MyServletA〃>This is an amazing servlet.</a> 
</BODY> 

</HTML> 
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servlets and JSP 


- BULLET POINTS - 

■ Servlets are Java classes that run entirely on 
(and/or within) an HTTP (web) server. 

■ Servlets are useful for running code on the 
server as a result of client interaction with a 
web page. For example, if a client submits 
information in a web page form, the servlet can 
process the information, add it to a database, 
and send back a customized, confirmation 
response page. 

■ To compile a servlet, you need the servlet 
packages which are in the servlets.jar file. The 
servlet classes are not part of the Java standard 
libraries, so you need to download the servlets, 
jar from java.sun.com or get them from a servlet- 
capable web server. (Note: the Servlet library 

is included with the Java 2 Enterprise Edition 
(J2EE)) 

■ To run a servlet, you must have a web server 
capable of running servlets, such as the Tomcat 
server from apache.org. 

■ Your servlet must be placed in a location that’s 
specific to your particular web server, so you’ll 
need to find that out before you try to run your 
servlets. If you have a web site hosted by an ISP 
that supports servlets, the ISP will tell you which 
directory to place your servlets in. 

■ A typical servlet extends HttpServlet and 
overrides one or more servlet methods, such as 
doGet() or doPost(). 

■ The web server starts the servlet and calls the 
appropriate method (doGet(), etc.) based on the 
client’s request. 

■ The servlet can send back a response by getting 
a PrintWriter output stream from the response 
parameter of the doGet() method. 

■ The servlet ‘writes’ out an HTML page, complete 
with tags). 


^lierei£irejio 

Dumb Questions 

What’s a JSP, and how does it relate to servlets? 

A. 

Jr \ m JSP stands for Java Server Pages. In the end, the web server 
turns a JSP into a servlet, but the difference between a servlet and 
a JSP is what YOU (the developer) actually create. With a servlet, 
you write a Java class that contains HTML in the output statements 
(if you’re sending back an HTML page to the client). But with a 
JSP, it’s the opposite —— you write an HTML page that contains Java 
code! 

This gives you the ability to have dynamic web pages where you 
write the page as a normal HTML page, except you embed Java 
code (and other tags that"trigger” Java code at runtime) that 
gets processed at runtime. In other words, part of the page is 
customized at runtime when the Java code runs. 

The main benefit of JSP over regular servlets is that it’s just a lot 
easier to write the HTML part of a servlet as a JSP page than to 
write HTML in the torturous print out statements in the servlet’s 
response. Imagine a reasonably complex HTML page, and now 
imagine formatting it within println statements. Yikes! 

But for many applications, it isn’t necessary to use JSPs because 
the servlet doesn’t need to send a dynamic response, or the 
HTML is simple enough not to be such a big pain. And, there are 
still many web servers out there that support servlets but do not 
support JSPs, so you’re stuck. 

Another benefit of JSPs is that you can separate the work by 
having the Java developers write the servlets and the web page 
developers write the JSPs.That’s the promised benefit, anyway. 

In reality, there’s still a Java learning curve (and a tag learning 
curve) for anyone writing a JSP, so to think that an HTML web page 
designer can bang out JSPs is not realistic. Well, not without tools. 
But that’s the good news — authoring tools are starting to appear, 
that help web page designers create JSPs without writing the 
code from scratch. 

Is this all you’re gonna say about servlets? After such a 
huge thing on RMI? 

A. 

Jr \ m Yes. RMI is part of the Java language, and all the classes for 
RMI are in the standard libraries. Servlets and JSPs are not part of 
the Java language; they’re considered standard extensions. You 
can run RMI on any modern JVM, but Servlets and JSPs require a 
properly configured web server with a servlet "container’: This is 
our way of saying,"it’s beyond the scope of this book.” But you can 
read much more in the lovely Head First Servlets & JSP. 
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Just for fuw, lefs make the Phrase - 0 - Mafic 
work as a servlet 
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Now that we told you that we won’t 
say any more about servlets, we can’t 
resist servletizing (yes, we can verbify 
it) the Phrase-O-Matic from chapter 1. 
A servlet is still just Java. And Java code 
can call Java code from other classes. 
So a servlet is free to call a method on 
the Phrase-O-Matic. All you have to do 
is drop the Phrase-O-Matic class into 
the same directory as your servlet, and 
you’re in business. (The Phrase-O- 
Matic code is on the next page). 



f Try my 
J new web-enabled 
phrase-o-matic and youll 
be a slick talker just like 
the boss or those guys in 
‘ marketing. ^ 〆 


import java.io.*; 


import javax.servlet•*; 
import javax.servlet.http.*; 


public class KathyServlet extends HttpServlet { 

public void doGet (HttpServletRequest request, HttpServletResponse response) 

throws ServletException, IOException { 


String title = ''PhraseOMatic has generated the following phrase .〃； 

response . setContentType (''text/html ’ , ）； 

PrintWriter out = response.getWriter(); 

out.println ( 、 '<HTMLXHEADXTITLE>"); 
out .println (''PhraseOmatic") ; 

out.println ( 、 '</TITLEX/HEADXBODY >〃）； / 

out • println ( 、 '<H1 >〃 + title + 、 '</Hl>〃> ; 
out.println ( 、 '<P>" + PhraseOMatic.makePhrase ()); 
out. println (''<PXa href=\’’KathyServlet\’’>make another phraseC/aX/pV'); 
out.println (''</BODYX/HTML>^); 

out.close(); 


soviet 6a, ^ali —H 二 
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Phrase-O-Matic code 


Phrase-O-Matic code, servlet-friewdly 

This is a slightly different version from the code in chapter one. In the 
original, we ran the entire thing in a main() method, and we had to rerun 
the program each time to generate a new phrase at the command-line. In this 
version, the code simply returns a String (with the phrase) when you invoke 
the static makePhrase() method. That way, you can call the method from any 
other code and get back a String with the randomly-composed phrase. 

Please note that these long String [] array assignments are a victim of word¬ 
processing here — don’t type in the hyphens! Just keep on typing and let your 
code editor do the wrapping. And whatever you do, don’t hit the return key in 
the middle of a String (i.e. something between double quotes). 


public class PhraseOMatic { 

public static String makePhrase() { 

// make three sets of words to choose from 

String[] wordListOne = {''24/7","multi-Tier","30,000 foot","B-to-B","win-win","front- 
end" , ''web-based’’ ， "pervasive", ''smart", 、 'six-sigma’’ ， "critical-path", ''dynamic"}; 

String[] wordListTwo = {''empowered", ''sticky", ''valued-added", ''oriented", ''centric", 
''distributed", ''clustered", ''branded 〃， ’ 'outside-the-box 〃， ''positioned” ， ''networked” ， ''fo¬ 
cused^ ,''leveraged", ''aligned", ''targeted", ''shared", ''cooperative", ''accelerated"}; 


String[] wordListThree = {''process", ''tipping point", ''solution", ''architecture", 
''core competency", ''strategy", ''mindshare", ''portal", ''space", ''vision", ''paradigm", 、 'mis- 
sion' , }; 


// find out how many words are in each list 
int oneLength = wordListOne.length; 
int twoLength = wordListTwo.length; 
int threeLength = wordListThree.length; 


// generate three random numbers , to pull random words from each list 


int randl = (int) 
int rand2 = (int) 
int rand3 = (int) 


(Math•random() 
(Math•random() 
(Math•random() 


* oneLength); 

* twoLength); 

* threeLength); 


// now build a phrase 

String phrase = wordListOne [randl] +'、、、+ wordListTwo [rand2] + 
wordListThree[rand3]; 


// now return it 

return (''What we need is a '' + phrase); 
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Enterprise JavaPeaws: RMI on steroids 

RMI is great for writing and running remote services. But 
you wouldn’t run something like an Amazon or eBay on RMI 
alone. For a large, deadly serious, enterprise application, you 
need something more. You need something that can handle 
transactions, heavy concurrency issues (like a gazillion 
people are hitting your server at once to buy those organic 
dog kibbles), security (not just anyone should hit your 
payroll database), and data management. For that, you need 
an enterprise application server. 

In Java, that means a Java 2 Enterprise Edition (J2EE) server. 
AJ2EE server includes both a web server and an Enterprise 
JavaBeans (EJB) server, so that you can deploy an application 
that includes both servlets and EJBs. Like servlets, EJB is 
way beyond the scope of this book, and there’s no way to 
show 4 just a little” EJB example with code, but we will take 
a quick look at how it works. (For a much more detailed 
treatment of EJB, we can recommend the lively Head First 
EJB certification study guide.) 


An EjB server adds a bunch 
of services you don’t get 

wi^i straight KMI. Tbings 
like transactions, security, 
concurrency, database 
iqanagement, and networking. 

An EjB server steps intone 
iqiddle of an 5MI call and 
layers in all of ^ie services. 











lets serve，do tW ^ 匕广 

^oa! TW»s tWc^i do ⑽七 ^ 
scdurjJ- dail th，s 

w 

^CV-C the 


扣 tOB server V^am^ 

DC sevver m. 



This is only a small part of the EJB picture! 
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a little Jini 



Jini uses RMI (although other protocols can be involved), but gives you a few 
key features including: 


Adaptive discovery 


Self-healing networks 


With RMI, remember, the client has to know the 
name and location of the remote service. The 
client code for the lookup includes the IP address or 
hostname of the remote service (because that’s where 
the RMI registry is running) and the logical name the 
service was registered under. 


But with Jini, the client has to know only one thing: the 
interface implemented by the service! That’s it. 


So how do you find things? The trick revolves around Jini lookup 
services. Jini lookup services are far more powerful and flexible than 
the RMI registry. For one thing, Jini lookup services announce themselves to the 
network, automatically. When a lookup service comes online, it sends a message (using IP 
multicast) out to the network saying, “I’m here, if anyone’s interested.” 


For our final trick... a little Jiwi 

We love Jini. We think Jini is pretty much the best thing in Java. If EJB is RMI 
on steroids (with a bunch of managers), Jini is RMI with wings. Pure Java bliss. 
Like the EJB material, we can’t get into any of the Jini details here, but if you 
know RMI, you’re three-quarters of the way there. In terms of technology, 
anyway. In terms of mindset, it’s time to make a big leap. No, it’s time to fly. 


M 




! 


I s . 




But that’s not all. Let’s say you (a client) come online after the lookup service has already 
announced itself, you can send a message to the entire network saying, “Are there any 
lookup services out there?” 


Except that you’re not really interested in the lookup service itself—you interested in 

the services that are registered with the lookup service. Things like RMI remote services, 
other serializable Java objects, and even devices such as printers, cameras, and coffee- 
makers. 


And here’s where it gets even more fun: when a service comes online, it will dynamically 
discover (and register itself with) any Jini lookup services on the network. When the 
service registers with the lookup service, the service sends a serialized object to be placed 
in the lookup service. That serialized object can be a stub to an RMI remote service, a 
driver for a networked device, or even the whole service itself that (once you get it from 
the lookup service) runs locally on your machine. And instead of registering by name, the 
service registers by the interface it implements. 

Once you (the client) have a reference to a lookup service, you can say to that lookup 
service, 44 Hey, do you have anything that implements ScientificCalculator?” At that point, 
the lookup service will check its list of registered interfaces, and assuming it finds a 
match, says back to you, 4 Yes I do have something that implements that interface. Here’s 
the serialized object the ScientificCalculator service registered with me.” 
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Adaptive discovery iw action 
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① Jini lookup service is launched somewhere on the network, and 
announces itself using IP multicast. 



machine on the network 


machine on the network 
somewhere... 


another machine on the network 


② An already-running Jini service on 

another machine asks to be registered 
with this newly-announced lookup 
service. It registers by capability, 
rather than by name. In other words, 
it registers as the service interface it 
implements. It sends a serialized object 
to be placed in the lookup service. 


Register 
me as something 
that implements 
ScientificCalculator. Here's a 
serialized object that represents 
my service. Send it to 
anybody who asks... 




Service 



another machine on the network 


machine on the network 
somewhere... 


another machine on the network 
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adaptive discovery in Jini 

Adaptive discovery iw action, continued... 


③ A client on the network wants 
something that implements the 
ScientificCalculator interface. It has 


no idea where (or if) that thing exists, 
so it asks the lookup service. 


machine on the network 
somewhere... 


another machine 
on the network 



another machine on the network 


④ The lookup service responds, since it does have something 
registered as a ScientificCalculator interface. 


— __ 



another machine on the network 


machine on the network 
somewhere... 


another machine on the network 
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Self-healing network iw action 


① A Jini Service has asked to register with the lookup service. The lookup 
service responds with a ''lease". The newly-registered service must keep 
renewing the lease, or the lookup service assumes the service has gone 
offline. The lookup service wants always to present an accurate picture 
to the rest of the network about which services are available. 



machine on the network 
somewhere... 


another machine 
on the network 


another machine on the network 


② The service goes offline (somebody shuts it down), so it fails to 
renew its lease with the lookup service. The lookup service drops it. 



another machine on the network 


machine on the network 
somewhere... 


another machine on the network 
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universal service project 


Final Project: the Universal Service browser 


We’re going to make something that isn’t Jini-enabled，but quite easily could be. 

It will give you the flavor and feeling of Jini，but using straight RMI. In fact the 
main difference between our application and ajini application is how the service is 
discovered. Instead of the Jini lookup service, which automatically announces itself and 
lives anywhere on the network, we’re using the RMI registry which must be on the same 
machine as the remote service, and which does not announce itself automatically. 

And instead of our service registering itself automatically with the lookup service, we 
have to register it in the RMI registry (using Naming.rebind ()). 

But once the client has found the service in the RMI registry, the rest of the application 
is almost identical to the way we’d do it in Jini. (The main thing missing is the lease that 
would let us have a self-healing network if any of the services go down.) 

The universal service browser is like a specialized web browser, except instead of HTML 
pages, the service browser downloads and displays interactive Java GUIs that we’re 
calling universal services. 


60 © 


RMI Browser 


Day of the Week Service 
Dice KoEting Service 


Visual Music Service 




Choose a SCV-Vi^C -Pvom 
list The RMI v-crr^oic SCVVi^C 
has a ytScwi^cLis-tO 
method 七 ha 七 sc^ds \>atk -this 

lis*t <Jc scwidcs. 

lA/hCh usev selects OV\t, 
•the di ⑶七 asks -fov 
actual scwi^c (PidcRoll'm^, 
PayO-fThd/Vcck, d) 七。 
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How it works: 

① Client starts up and 
does a lookup on the 
RMI registry for 
the service called 
''ServiceServer", and 
gets back the stub. 



Service Browser 
(client) 


Server 


RMI registry (on server) 


② Client calls getServiceList() on the stub. The ServiceServer 
returns an array of services 



OK, here's an array of services 


ji 


Service Browser 

(client) u getServiceList(y , 


Server 


③ Client displays the list of services in a GUI 


Service Browser 


(client) 



Server 
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universal service browser 


How it works, continued... 


④ User selects from the list, so client calls the getService() 
method on the remote service. The remote service returns a 
serialized object that is an actual service that will run inside 
the client browser. 



Service Browser 
(client) 


u g0tS0rvic0(S0lect0dSvcy , 


,l OK, here's the service 


Server 


⑤ Client calls the getSuiPanel() on the serialized service object it 
just got from the remote service. The GUI for that service is 
displayed inside the browser, and the user can interact with it 
locally. At this point, we don't need the remote service unless/until 
the user decides to select another service. 

Service Browser 
(client) 
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The classes and interfaces: 


① interface ServiceServer implements Remote 

A regular old RMI remote interface for the remote service (the 
remote service has the method for getting the service list and 
returning a selected service). 

② class ServiceServerlmpI implements ServiceServer 

The actual RMI remote service (extends UnicastRemoteObject). 
Its job is to instantiate and store all the services (the things 
that will be shipped to the client), and register the server itself 
(ServiceServerlmpI) with the RMI registry. 


ServiceServer 

getServicesListf) 

getServicef) 


■ 

■ 

_I_ 

ServiceServerlmpI 

getServicesList() 

getService() 


③ class Service Browser 

The client. It builds a very simple GUI, does a lookup in the RMI 
registry to get the ServiceServer stub, then calls a remote method on 
it to get the list of services to display in the GUI list. 


ServiceBrowser 

main() 


④ 


⑤ 


⑥ 


⑦ 


interface Service 


This is the key to everything. This very simple interface has just one 
method, getGuiPanel(). Every service that gets shipped over to the 
client must implement this interface. This is what makes the whole thing 
UNIVERSAL! By implementing this interface, a service can come over 
even though the client has no idea what the actual class (or classes) 
are that make up that service. All the client knows is that whatever 
comes over, it implements the Service interface, so it MUST have a 
get(5uiPanel() method. 

The client gets a serialized object as a result of calling 
getService(selectedSvc) on the ServiceServer stub, and all the client 
says to that object is, U I don’t know who or what you ore, but I DO 
know that you implement the Service interface, so I know I can call 
getGuiPanel() on you. And since getGuiPanel() returns a JPanel, Til just 
slap it into the browser GUI and start interacting with it! 


Service 

getGuiPanelf) 



class DiceService implements Service 

Got dice? If not, but you need some, use this service to roll anywhere 
from 1 to 6 virtual dice for you. 

class MiniMusicService implements Service 

Remember that fabulous little 'music video* program from the first 
GUI Code Kitchen? Weve turned it into a service, and you can play it 
over and over and over until your roommates finally leave. 

class DayOfTheWeekService implements Service 

Were you born on a Friday? Type in your birthday and find out. 


/ DiceService 


getGuiPanelQ 



DayOfTheWeekService 

getGuiPanelQ 




MiniMusicService 

getGuiPanelQ 
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universal service code 


interface ServiceServer (the remote interface) 

import java.rmi.*; 

public interface ServiceServer extends Remote { 

Object[] getServiceList() throws RemoteException; 


，一 \ _ 一你 




Service getService(Object serviceKey) throws RemoteException; 


interface Service (what the GUI services implement) 


import javax.swing.*; 
import java.io.*; 

public interface Service extends Serializable { 
public JPanel getGuiPanel(); 


^ The 
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class ServiceServerlmpI (the remote implementation) 


remote deployment witl RMI 


import java.rmi.*; 
import java.util.*; 
import java.rmi.server.*; 


yxovwv 


a \ m\ … 山七⑽ 


public class ServiceServerlmpI extends UnicastRemoteObject implements ServiceServer { 


HashMap serviceList; 




y° u ^i). (see 




a 


public ServiceServerlmpI() throws RemoteException 
setUpServices(); 


,,w 一一 


private void setUpServices() { 

serviceList = new HashMap(); 
serviceList.put (''Dice Rolling Service", new DiceService ()); 
serviceList .put (''Day of the Week Service", new DayOf TheWeekService ()); 



serviceList .put (''Visual Music Service 


public Object[] getServiceList() { 

System, out .pr in tin (''in remote"); 
return serviceList.keySet().toArray(); 


new MiniMusicService()); . .“ 

Vf). 



inside) b 

ih 

Uhlcss *t 
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public Service getService(Object serviceKey) throws RemoteException 
Service theService = (Service) serviceList.get(serviceKey); 
return theService; 




public static void main (String[] args) { 
try { 

Naming. rebind (''ServiceServer", new ServiceServerlmpI ()); 
} catch(Exception ex) { 
ex.printStackTrace(); 

} 

System. out. println (''Remote service is running"); 


you are here 
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ServiceBrowser code 

class ServiceBrowser (the client) 

import java.awt.*; 
import javax.swing.*; 
import java.rmi.*; 
import java.awt.event.*; 

public class ServiceBrowser { 

JPanel mainPanel; 

JComboBox serviceList; 

ServiceServer server; 

public void buildGUI() { 

JFrame frame = new JFrame (''RMI Browser"); 
mainPanel = new JPanel(); 

frame.getContentPane().add(BorderLayout.CENTER, mainPanel); 


二 D A/ll \ooW? 



Object[] services = getServicesList(); 


serviceList = new JComboBox(services); 


frame.getContentPane().add(BorderLayout.NORTH, serviceList); 

serviceList.addActionListener(new MyListListener()); 

frame.setSize(500,500); 
frame.setVisible(true); 


void loadService(Object serviceSelection) { 
try { 

Service svc = server.getService(serviceSelection); 


} catch(Exception ex) { 
ex.printstackTrace(); 


mainPanel.removeAll(); 


mainPanel.add(svc.getGuiPanel()); 


mainPanel.validate(); 
mainPanel.repaint(); 




642 


remote deployment witl RMI 


Object[] getServicesList() { 
Object obj = null; 

Object[] services = null; 


Po RMI \ooW， 




try { nT 

obj = Naming. lookup (''rmi : //127.0.0. l/ServiceServer^); 


catch(Exception ex) { 
ex.printstackTrace(); 

} ^ 

server = (ServiceServer) obj 


try { 

services = server.getServiceList() 

} catch(Exception ex) { 
ex.printStackTrace(); 

} 

return services; 






ac*tSc\rvidcLis*tO jives us Srrsy o-f Objects, 
that v/c display'm 七 he JComboBoy. -fov- usev- *to 
select 


class MyListListener implements ActionListener { 
public void actionPerformed(ActionEvent ev) { 

Object selection = serviceList.getSelectedltem() 
loadService(selection); 



tV>C 必 cv 
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public static void main(String[] args) { 
new ServiceBrowser().buildGUI(); 
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class DiceService (a universal service，implements Service) 


import javax.swing.*; 
import java.awt.event.*; 
import java.io.*; 

public class DiceService implements Service 

JLabel label; 

JComboBox numOfDice; 




public JPanel getGuiPanel() { 

JPanel panel = new JPanel(); 

JButton button = new JButton (''Roll 'em!") 
String[] choices = {''1", 、 '2", 、 '3", 、 '4", 、 '5"}; 
numOfDice = new JComboBox (choices); 
label = new JLabel (''dice values here 〃）； 
button.addActionListener(new RollEmListener()) 


0 0 0 


RMI Browser 


Dice Rolling Service 


^ f Roll 'em! 1 5 2 6 


panel. add (numOfDice) 
panel.add(button); 
panel.add(label); 
return panel; 


this is sc | 沾 d th 二 “ ⑶ 

wah-t ih the gc-t^uiPa^lO ^ ^ y<>“ 

public class RollEmListener implements ActionListener { 


public void actionPerformed(ActionEvent ev) { 
// roll the dice 


String diceOutput = 、、〃； 

String selection = (String) numOfDice.getSelectedltem(); 
int numOfDiceToRoll = Integer.parselnt(selection); 
for (int i = 0; i < numOfDiceToRoll; i++) { 
int r = (int) ((Math.random() * 6) + 1); 
diceOutput += ('、'、+ r); 

} 

label.setText(diceOutput); 


i^^rpen your pencil 


Think about ways to improve the DiceService. One 
suggestion: using what you learned in the GUI chapters, 
make the dice graphical. Use a rectangle, and draw the 
appropriate number of circles on each one, corresponding 
to the roll for that particular die. 
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class MiniMusicService (a universal service，implements Service) 


import javax.sound.midi.*; 
import java.io.*; 
import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 


public class MiniMusicService implements Service { 


MyDrawPanel myPanel; 


public JPanel getGuiPanel() { 

JPanel mainPanel = new JPanel(); 
myPanel = new MyDrawPanel(); 

JButton playltButton = new JButton (''Play it"); 
playltButton.addActionListener(new PlayltListener()); 


TV^e I;' 口 L 
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mainPanel.add(myPanel); 


mainPanel.add(playltButton); 


return mainPanel; 


public class PlayltListener implements ActionListener 
public void actionPerformed(ActionEvent ev) { 


try { 


This is all the r,usi^ sUd the 

Co * 仙 kh ih dhaptev- 11, so WC 
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Sequencer sequencer = MidiSystem.getSequencer(); 
sequencer.open(); 


sequencer.addControllerEventListener(myPanel, new int[] {127}); 

Sequence seq = new Sequence(Sequence.PPQ, 4); 

Track track = seq.createTrack(); 


for (int i = 0; i < 100; i+= 4) { 


int rNum = (int) ((Math.random() * 50) + 1); 

if (rNum < 38) { // so now only do it if num <38 (75% of the time) 

track.add(makeEvent(144,1,rNum,100,i)); 
track.add(makeEvent(176,1,127,0,i)); 
track.add(makeEvent(128,1,rNum,100,i + 2)); 

} 

} // end loop 


sequencer.setSequence(seq); 
sequencer.start(); 
sequencer.setTempoInBPM(220); 

} catch (Exception ex) {ex.printstackTrace();} 

} // close actionperformed 
} // close inner class 
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MiniMusicService code 


class MiniMusicService, continued... 


public MidiEvent makeEvent(int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage(); 
a.setMessage(comd, chan, one, two); 
event = new MidiEvent(a, tick); 

}catch(Exception e) { } 
return event; 


class MyDrawPane1 extends JPanel implements ControllerEventListener { 


// only if we got an event do we want to paint 
boolean msg = false; 


public void controlChange(ShortMessage event) 
msg = true; 
repaint(); 


public Dimension getPreferredSize() { 
return new Dimension(300,300); 


K, 


public void paintComponent(Graphics g) { 
if (msg) { 

Graphics2D g2 = (Graphics2D) g; 

int r = (int) (Math.random() * 250); 
int gr = (int) (Math.random() * 250); 
int b = (int) (Math.random() * 250); 

g.setColor(new Color(r,gr,b)); 

int ht = (int) ((Math.random() * 120) + 10); 
int width = (int) ((Math.random() * 120) + 10); 

int x = (int) ((Math.random() * 40) + 10); 
int y = (int) ((Math.random() * 40) + 10 〉； 

g.fillRect (x,y ,ht, width); 
msg = false; 

} // close if 
} // close method 
} // close inner class 

} // close class 
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class DayOfTheWeekService (a universal service，implements Service) 


import javax.swing.*; 
import java.awt.event.*; 
import java.awt.*; 
import java.io.*; 
import java.util.*; 
import java.text.*; 

public class DayOfTheWeekService implements Service { 

JLabel outputLabel; 

JComboBox month; 

JTextField day; 

JTextField year; 

public JPanel getGuiPanel() { 

JPanel panel = new JPanel(); 

JButton button = new JButton (''Do it!"); 
button.addActionListener(new DoItListener()); 



㈣ 放 r 





outputLabel = new JLabel (''date appears here"); 
DateFormatSymbols datestuff = new DateFormatSymbols(); 
month = new JComboBox(dateStuff.getMonths()); 
day = new JTextField(8); 
year = new JTextField(8); 

JPanel inputPanel = new JPanel(new GridLayout(3,2)); 

inputPanel. add (new JLabel (''Month")); 

inputPanel.add(month); 

inputPanel. add (new JLabel (''Day")); 

inputPanel.add(day); 

inputPanel. add (new JLabel (''Year")); 

inputPanel.add(year); 

panel.add(inputPanel); 

panel.add(button); 

panel.add(outputLabel); 

return panel; 


public class DoItListener implements ActionListener { 
public void actionPerformed(ActionEvent ev) { 
int monthNum = month.getSelectedlndex(); 
int dayNum = Integer.parseInt(day.getText()); 
int yearNum = Integer.parselnt(year.getText()); 
Calendar c = Calendar.getlnstance(); 
c.set(Calendar.MONTH, monthNum); 
c•set(Calendar.DAY 一 OF 一 MONTH, dayNum); 
c.set(Calendar.YEAR, yearNum); 

Date date = c.getTime(); 

String dayOfWeek = (new SimpleDateFormat (''EEEE 
outputLabel.setText(dayOfWeek); 





Jfov V^OYI 




)) .format(date); 
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the end... sort of 



Congratulations! 

You matte it to tke encL 


Of course, there’s still the two appendices. 
And the index. 

And then there’s the web site... 

There’s no escape, really. 
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Appendix A ： 

Final Code Kitcken 





e o o 


Cyber BeatBox 
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Low-mid Tom □ □□□□□□□□□QQOOQQ 
High Agogo □□□□□□□ □□□□□□□□□ 
Open Hi CongaQ |~H f~ ^ i?1 1 j !~~1 f~] l~H @ @ □ 


Hsgh Tom 

He Bongo 

Maracas 

Whistle 

Low Conga 

Cowbell 

Vibrasiap 


Start 


"V 


Stop 


Tempo Up 
Tempo Down 


sendlt 


dance beat 


Andy: groove #2 
Chris: groove2 revised 
Nigel: dance beat 
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Finally, tke complete version ol tke BeatBox! 


^« y pr^ i° he io 1 
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It connects to a simple MusicServer so tkat you can 
senct and receive teat patterns witk otker clients. 
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final BeatBox code 


Final BeatBox client program 

Most of this code is the same as the code from the CodeKitchens in the previous 
chapters, so we don’t annotate the whole thing again. The new parts include: 

GUI - two new components are added for the text area that displays incoming 
messages (actually a scrolling list) and the text field. 

NETWORKING - just like the SimpleChatClient in this chapter, the BeatBox now 
connects to the server and gets an input and output stream. 

THREADS - again, just like the SimpleChatClient, we start a ‘reader’ class that 
keeps looking for incoming messages from the server. But instead of just text, the 
messages coming in include TWO objects: the String message and the serialized 
ArrayList (the thing that holds the state of all the checkboxes.) 


import 

import 

import 

import 

import 

import 

import 

import 


java.awt.*; 
javax.swing.*; 
java.io.*; 
javax.sound.midi.*; 
java.util.*; 
java.awt.event.*; 
java.net.*; 
javax.swing.event.*; 


public class BeatBoxFinal { 


JFrame theFrame; 

JPanel mainPanel; 

JList incomingList; 

JTextField userMessage; 

ArrayList<JCheckBox> checkboxList; 
int nextNum ; 

Vector<String> listVector = new Vector<String>(); 

String userName; 

ObjectOutputStream out; 

ObjectlnputStream in; 

HashMap<String, boolean[]> otherSeqsMap = new HashMap<String, boolean[]>(); 

Sequencer sequencer; 

Sequence sequence; 

Sequence mySequence = null; 

Track track; 

String[] instrumentNames = {''Bass Drum", ''Closed Hi-Hat", ''Open Hi-Hat”，"Acoustic 
Snare’’，''Crash Cymbal", ''Hand Clap’’，''High Tom’’，''Hi Bongo’’ ， ''Maracas’’ ， ''Whistle ’’， 
''Low Conga", ''Cowbell", ''Vibraslap", ''Low-mid Tom", ''High Agogo", ''Open Hi Conga’’}; 

int[] instruments = {35,42,46,38,49,39,50,60,70,72,64,56,58,47,67,63}; 
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public static void main (String[] args) { 
new BeatBoxFinal().startup(args[0]); // 

} 

public void startup(String name) { 
userName = name; 



args[0] is your user ID/screen name 

A aaa 一 a - w w “ 。”一 c . 

% java 歸 B 。 ⑽ 


// open connection to the server 
try { 

Socket sock = new Socket (''127 • 0 • 0 • 1 〃， 4242); 
out = new ObjectOutputStream(sock.getOutputStream()); 
in = new ObjectInputStream(sock.getInputStream()); 
Thread remote = new Thread(new RemoteReader()); 


娜 rtf 


remote.start(); 

} catch(Exception ex) { 

System, out .pr in tin (''couldn^ t connect - you'll have to play alone . ,r ); 


setUpMidi (); 
buildGUI(); 


} // close startup 


public void buildGUI () { gy\o 七 

the Frame = new JFrame (''Cyber BeatBox"); 

BorderLayout layout = new BorderLayout(); 

JPanel background = new JPanel(layout); 

background.setBorder(BorderFactory.createEmptyBorder(10,10,10,10)); 


checkboxList = new ArrayList<JCheckBox>(); 


Box buttonBox = new Box(BoxLayout.Y_AXIS); 
JButton start = new JButton(' 、 Start 〃）； 
start.addActionListener(new MyStartListener()); 
buttonBox.add(start); 


JButton stop = new JButton (''Stop ,r ); 

stop.addActionListener(new MyStopListener()); 

buttonBox.add(stop); 

JButton upTempo = new JButton (''Tempo Up"); 
upTempo.addActionListener(new MyUpTempoListener()); 
buttonBox.add(upTempo); 

JButton downTempo = new JButton (''Tempo Down"); 
downTempo.addActionListener(new MyDownTempoListener()); 
buttonBox.add(downTempo); 


JButton sendlt = new JButton ( 、 'sendlt 〃）； 
sendlt.addActionListener(new MySendListener()); 
buttonBox.add(sendlt); 


userMessage = new JTextField(); 
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buttonBox.add(userMessage); 


incomingList = new JList(); 

incomingList.addListSelectionListener(new MyListSelectionListener()); 
incomingList.setSelectionMode(ListSelectionModel.SINGLE—SELECTION); 
JScrollPane theList = new JScrollPane(incomingList); 
buttonBox.add(theList); 

incomingList.setListData(listVector); // no data to start with 


Box nameBox = new Box(BoxLayout.Y_AXIS); 
for (int i = 0; i < 16; i++) { 

nameBox.add(new Label(instrumentNames[i])); 


background.add(BorderLayout.EAST, buttonBox); 
background.add(BorderLayout.WEST, nameBox); 

theFrame.getContentPane().add(background); 
GridLayout grid = new GridLayout(16,16); 
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grid.setVgap(1); 
grid.setHgap(2); 
mainPanel = new JPanel(grid); 

background.add(BorderLayout.CENTER, mainPanel); 


for (int i = 0; i < 256; i++) { 

JCheckBox c = new JCheckBox(); 
c.setSelected(false); 
checkboxList.add(c); 
mainPanel.add(c); 

} // end loop 


Wothmg else oh this page is 


theFrame.setBounds(50,50,300,300); 

theFrame.pack(); 

theFrame.setVisible(true); 

} // close buildGUI 


public void setUpMidi() { 
try { 

sequencer = Midi System. ge tSequencer (); 
sequencer.open(); 

sequence = new Sequence(Sequence.PPQ,4); 
track = sequence.createTrack(); 
sequencer.setTempoInBPM(120); 

} catch(Exception e) {e.printStackTrace();} 






} // close setUpMidi 
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public void buildTrackAndStart() { 

ArrayList<Integer> trackList = null 
sequence.deleteTrack(track); 
track = sequence.createTrack(); 


// this will hold the instruments for each 


itsgis 


for (int i = 0; i < 16; i++) { 

trackList = new ArrayList<Integer>() 


TW»s ㈣ 切 


as vt 
to 
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for (int j = 0; j < 16; j++) { 

JCheckBox jc = (JCheckBox) checkboxList.get(j + (16*i)); 
if (jc.isSelected()) { 

int key = instruments[i]; 
trackList.add(new Integer(key)); 




} else { 

trackList.add(null); // because this slot should be empty in the track 

} 

} // close inner loop 

makeTracks(trackList); 

} // close outer loop 

track.add(makeEvent(192,9,1,0,15)>; // - so we always go to full 16 beats 
try { 

sequencer.setSequence(sequence); 

sequencer.setLoopCount(sequencer.LOOP 一 CONTINUOUSLY); 

sequencer.start(); 

sequencer.setTempoInBPM(120); 

} catch(Exception e) {e.printStackTrace();} 

} // close method 


public class MyStartListener implements ActionListener { 
public void actionPerformed(ActionEvent a) { 
buildTrackAndStart(); 

} // close actionPerformed 
} // close inner class 

public class MyStopListener implements ActionListener { 
public void actionPerformed(ActionEvent a) { 
sequencer.stop(); 

} // close actionPerformed 
} // close inner class 


丁 V^s- 
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public class MyUpTempoListener implements ActionListener { 
public void actionPerformed(ActionEvent a) { 

float tempoFactor = sequencer.getTempoFactor(); 
sequencer. setTempoFactor ((float) (tempoFactor * 1.03)); 

} // close actionPerformed 
} // close inner class 
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public class MyDownTempoListener implements ActionListener { 
public void actionPerformed(ActionEvent a) { 
float tempoFactor = sequencer.getTempoFactor(); 
sequencer. setTempoFactor ( (float) (tempoFactor * . 97)); 


public class MySendListener implements ActionListener { 
public void actionPerformed(ActionEvent a) { 

// make an arraylist of just the STATE of the checkboxes 
boolean[] checkboxState = new boolean[256]; 
for (int i = 0; i < 256; i++) { 



JCheckBox check = (JCheckBox) checkboxList.get(i); 
if ( check. isSelected ()) f . i \ 



} // close loop 

String messageToSend = null; 


try { 

out. writeObject (userName + nextNum++ + '' : '' + userMessage. getText ()); 
out.writeObject(checkboxState); 

} catch(Exception ex) { 

System, out .pr in tin (''Sorry dude. Could not send it to the server •〃）； 

} 

userMessage . setText (' w, ); 

} // close actionPerformed 
} // close inner class 

public class MyListSelectionListener implements ListSelectionListener { 
public void valueChanged(ListSelectionEvent le) { 
if (!le.getValuelsAdjusting()) { 


String selected = (String) incomingList.getSelectedValue(); 
if (selected != null) { 

// now go to the map, and change the sequence 
boolean[] selectedState = (boolean[]) otherSeqsMap.get(selected); 
changeSequence(selectedState); 
sequencer.stop(); 
buildTrackAndStart(); 


} // close valueChanged 
} // close inner class 
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public class RemoteReader implements Runnable { 
boolean[] checkboxState = null; 

String nameToShow = null; 

Object obj = null; 
public void run() { 

try { 

while((obj=in.readObject()) != null) { 一， j , 

System. out.println (''got an object from serv^Sf^*^^ 15 ° 
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System.out.println(obj.getClass()); 


String nameToShow = (String) obj; 
checkboxState = (boolean[]) in.readObject() 
otherSeqsMap.put(nameToShow, checkboxState) 
listVector.add(nameToShow); 
incomingList.setListData(listVector); 

} // close while 

} catch(Exception ex) {ex.printstackTrace();} 

} // close run 

} // close inner class 

public class MyPlayMineListener implements ActionList 
public void actionPerformed(ActionEvent a) { 


卜 i ioihT it 


if (mySequence != null) { 

sequence = mySequence; // restore to my original 


} // close actionPerformed 
} // close inner class 

public void changeSequence(boolean[] checkboxS 
for (int i = 0; i < 256; i++) { 

JCheckBox check = (JCheckBox) checkboxList.get(i); 
if (checkboxState[i]) { 

check.setSelected(true); 

} else { 

check.setSelected(false); 




} // close loop 
} // close changeSequence 


AH is e ， 如一 as Vt 
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public void makeTracks(ArrayList list) { 

Iterator it = list.iterator(); 
for (int i = 0; i < 16; i++) { 

Integer num = (Integer) it.next(); 
if (num != null) { 

int numKey = num.intValue(); 

track•add(makeEvent(144,9,numKey, 100, i)); 

track•add(makeEvent(128,9,numKey,100, i + 1)); 

} 

} // close loop 
} // close makeTracks() 
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public MidiEvent makeEvent(int comd, int chan, int one, int two, int tick) 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage(); 
a.setMessage(comd, chan, one, two); 
event = new MidiEvent(a, tick); 

}catch (Exception e) { } \ as ^ 

return event; ^ - JvAst U 

■ // close makeEvent 




// close class 


f^arpen your pencil 



What are some of the ways you can improve this program? 

Here are a few ideas to get you started: 

1) Once you select a pattern, whatever current pattern was playing is blown 
away. If that was a new pattern you were working on (or a modification of 
another one), you’re out of luck. You might want to pop up a dialog box that 
asks the user if he’d like to save the current pattern. 


2) If you fail to type in a command-line argument, you just get an exception 
when you run it! Put something in the main method that checks to see if 
you’ve passed in a command-line argument. If the user doesn’t supply one, 
either pick a default or print out a message that says they need to run it 
again, but this time with an argument for their screen name. 


3) It might be nice to have a feature where you can click a button and it 
will generate a random pattern for you. You might hit on one you really like. 
Better yet, have another feature that lets you load in existing 'foundation' 
patterns, like one for jazz, rock, reggae, etc. that the user can add to. 

You can find existing patterns on the Head First Java web start. 
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Final BeatBox server program 

Most of this code is identical to the SimpleChatServer we made in the 
Networking and Threads chapter. The only difference, in fact, is that this server 
receives, and then re-sends, two serialized objects instead of a plain String 
(although one of the serialized objects happens to be a String). 


import java.io.*; 
import java.net.*; 
import java.util.*; 

public class MusicServer { 

ArrayList<ObjectOutputStream> clientOutputStreams; 

public static void main (String[] args) { 
new MusicServer().go(); 

} 

public class ClientHandler implements Runnable { 

ObjectlnputStream in; 

Socket clientSocket; 

public ClientHandler(Socket socket) { 
try { 

clientSocket = socket; 

in = new ObjectlnputStream(clientSocket.getInputStream()); 

} catch(Exception ex) {ex•printstackTrace();} 

} // close constructor 


public void run() { 

Object o2 = null; 
Object ol = null; 
try { 


while ((ol = in.readObject()) != null) { 
o2 = in.readObject(); 

System, out .pr in tin (''read two objects"); 
te1IEveryone(ol, o2); 

} // close while 

} catch(Exception ex) {ex•printstackTrace();} 

} // close run 

} // close inner class 
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public void go () { 

clientOutputStreams = new ArrayList<ObjectOutputStream>(); 
try { 

ServerSocket serverSock = new ServerSocket(4242); 
while(true) { 

Socket clientSocket = serverSock.accept(); 

ObjectOutputStream out = new ObjectOutputStream(clientSocket.getOutputStream()); 
clientOutputStreams.add(out); 

Thread t = new Thread(new ClientHandler(clientSocket)); 
t.start(); 

System, out .println (''got a connection"); 

} 

}catch(Exception ex) { 
ex.printStackTrace(); 

} 

} // close go 

public void telIEveryone(Object one. Object two) { 

Iterator it = clientOutputStreams.iterator(); 
while(it.hasNext()) { 
try { 

ObjectOutputStream out = (ObjectOutputStream) it.next(); 
out.writeObject(one); 
out.writeObject(two); 

}catch(Exception ex) {ex.printstackTrace();} 

} 

} // close tellEveryone 
} // close class 
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Appendix B 

The Top Ten Topics that almost made it into the Real Book … 



We covered a lot of ground, and you’re almost finished with this book. We’ll miss you, but before 
we let you go, we wouldn’t feel right about sending you out into JavaLand without a little more 
preparation. We can’t possibly fit everything you’ll need to know into this relatively small appendix. 
Actually, we did originally include everything you need to know about Java (not already covered by 
the other chapters), by reducing the type point size to .00003. It all fit, but nobody could read it. So, 
we threw most of it away, but kept the best bits for this Top Ten appendix. 

This really is the end of the book. Except for the index (a must-read!). 
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#10 Bit Manipulation 

Why do you care? 

We’ve talked about the fact that there are 8 bits in a byte, 

16 bits in a short, and so on. You might have occasion to 
turn individual bits on or off. For instance you might find 
yourself writing code for your new Java enabled toaster, 
and realize that due to severe memory limitations, certain 
toaster settings are controlled at the bit level. For easier 
reading, we’re showing only the last 8 bits in the comments 
rather than the full 32 for an int). 

Bitwise NOT Operator: ~ 

This operator 'flips all the bits’ of a primitive. 

int x = 10; // bits are 00001010 

x = -x; // bits are now 11110101 

The next three operators compare two primitives on a bit 
by bit basis, and return a result based on comparing these 
bits. We’ll use the following example for the next three 
operators: 

int x = 10; // bits are 00001010 

int y = 6; // bits are 00000110 

Bitwise AND Operator: & 

This operator returns a value whose bits are turned on only 
if both original bits are turned on: 

int a = x & y; // bits are 00000010 

Bitwise OR Operator: 

This operator returns a value whose bits are turned on only 
if either of the original bits are turned on: 

int a = x I y; // bits are 00001110 

Bitwise XOR (exclusive OR) Operator: A 

This operator returns a value whose bits are turned on only 
if exactly one of the original bits are turned on: 

int a = x ^ y; // bits are 00001100 


The Shift Operators 

These operators take a single integer primitive and shift (or 
slide) all of its bits in one direction or another. If you want 
to dust off your binary math skills, you might realize that 
shifting bits left effectively multiplies a number by a power of 
two, and shifting bits right effectively divides a number by a 
power of two. 

We’ll use the following example for the next three operators: 

int x = -11; // bits are 11110101 

Ok, ok, we’ve been putting it off, here is the world’s 
shortest explanation of storing negative numbers, and 
two’s complement. Remember, the leftmost bit of an integer 
number is called the sign bit. A negative integer number in 
Java always has its sign bit turned on (i.e. set to 1). A positive 
integer number always has its sign bit turned off (0). Java 
uses the two’s complement formula to store negative numbers. 
To change a number’s sign using two’s complement, flip all 
the bits, then add 1 (with a byte, for example, that would 
mean adding 00000001 to the flipped value). 

Right Shift Operator: >> 

This operator shifts all of a number’s bits right by a certain 
number, and fills all of the bits on the left side with whatever 
the original leftmost bit was. The sign bit does not change: 

int y = x >> 2; // bits are 11111101 

Unsigned Right Shift Operator: >>> 

Just like the right shift operator BUT it ALWAYS fills the 
leftmost bits with zeros. The sign bit might change: 

int y = x >>> 2; // bits are 00111101 

Left Shift Operator: « 

Just like the unsigned right shift operator, but in the other 
direction; the rightmost bits are filled with zeros. The sign bit 
might change. 

int y = x << 2; / / bits are 11010100 
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Why do you care that Strings are Immutable? 

When your Java programs start to get big, you’ll 
inevitably end up with lots and lots of String objects. 
For security purposes, and for the sake of conserving 
memory (remember your Java programs can run on 
teeny Java-enabled cell phones), Strings in Java are 
immutable. What this means is that when you say: 

String s = ' 、 0〃; 

for (int x = 1; x < 10 ； x++) { 
s = s + x; 

} 

What’s actually happening is that you’re creating ten 
String objects (with values “0”, “01”, “012”， through 
“0123456789”）. In the end 5 is referring to the String 
with the value “0123456789”，but at this point there 
are ten Strings in existence! 

Whenever you make a new String, the JVM puts it 
into a special part of memory called the ‘String Pool’ 
(sounds refreshing doesn’t it?). If there is already 
a String in the String Pool with the same value, the 
JVM doesn’t create a duplicate, it simply refers your 
reference variable to the existing entry. The JVM can 
get away with this because Strings are immutable; one 
reference variable can’t change a String’s value out 
from under another reference variable referring to 
the same String. 

The other issue with the String pool is that the 
Garbage Collector doesn’t go there. So in our example, 
unless by coincidence you later happen to make a 
String called “01234”， for instance, the first nine 
Strings created in our/or loop will just sit around 
wasting memory. 

How does this save memory? 

Well, if you’re not careful, it doesn’t'. But if you un¬ 
derstand how String immutability works, than you 
can sometimes take advantage of it to save memory. 

If you have to do a lot of String manipulations (like 
concatenations, etc.) ， however, there is another class 
StringBuilder, better suited for that purpose. We’ll 
talk more about StringBuilder in a few pages. 


Why do you care that Wrappers arc 
Immutable? 

In the Math chapter we talked about the two main 
uses of the wrapper classes: 

• Wrapping a primitive so it can pretend to be an 
object. 

• Using the static utility methods (for example, 
Integer.parselnt()). 

It’s important to remember that when you create a 
wrapper object like: 

Integer iWrap = new Integer(42 )； 

That’s it for that wrapper object. Its value will always 
be 42. There is no setter method for a wrapper object 
You can, of course, refer iWrap to a different wrapper 
object, but then you’ll have two objects. Once you 
create a wrapper object, there’s no way to change 
the value of that object! 



you are here ► 661 






assertions 


#8 Assertions 

We haven’t talked much about how to debug your Java 
program while you’re developing it. We believe that 
you should learn Java at the command line, as we’ve 
been doing throughout the book. Once you’re a Java 
pro, if you decide to use an IDE*，you might have 
other debugging tools to use. In the old days, when 
a Java programmer wanted to debug her code, she’d 
stick a bunch of System.out.println( ) statements 
throughout the program, printing current variable 
values, and “I got here” messages, to see if the flow 
control was working properly. (The ready-bake code 
in chapter 6 left some debugging ‘print’ statements 
in the code.) Then, once the program was working 
correctly, she’d go through and take all those System. 
out.println( ) statements back out again. It was 
tedious and error prone. But as of Java 1.4 (and 5.0), 
debugging got a whole lot easier. The answer? 

Assertions 

Assertions are like System.out.println( ) statements 
on steroids. Add them to your code as you would 
add println statements. The Java 5.0 compiler 
assumes you’ll be compiling source files that are 5.0 
compatible, so as of Java 5.0, compiling with assertions 
is enabled by default. 

At runtime, if you do nothing, the assert statements 
you added to your code will be ignored by the JVM, 
and won’t slow down your program. But if you tell the 
JVM to enable your assertions, they will help you do 
your debugging, without changing a line of code! 

Some folks have complained about having to leave 
assert statements in their production code, but 
leaving them in can be really valuable when your 
code is already deployed in the field. If your client 
is having trouble, you can instruct the client to run 
the program with assertions enabled, and have the 
client send you the output. If the assertions were 
stripped out of your deployed code, you’d never 
have that option. And there is almost no downside; 
when assertions are not enabled, they are completely 
ignored by the JVM, so there’s no performance hit to 
worry about. 


How to make Assertions work 

Add assertion statements to your code wherever you 
believe that something must be true. For instance: 

assert (height > 0); 

// if true, program continues normally 
// if false, throw an AssertionError 

You can add a little more information to the stack 
trace by saying: 

assert (height > 0) : ''height = '、+ 

height + '、weight = '、+ weight; 

The expression after the colon can be any legal 
Java expression that resolves to a non-null value. But 
whatever you do, don’t create assertions that change an 
object’s state! If you do, enabling assertions at runtime 
might change how your program performs. 

Compiling and running with 
Assertions 

To compile with assertions: 

j avac TestDriveGame.j ava 

(Notice that no command line options were 
necessary.) 

To run with assertions: 

j ava -ea TestDriveGame 


* IDE stands for Integrated Development Environment 
and includes tools such as Eclipse, Borland’s JBuilder, or 
the open source NetBeans (netbeans.org). 


662 


appendix B Top Ten Reference 


#7 Block Scope 


In chapter 9, we talked about how local variables 
live only as long as the method in which they’re 
declared stays on the stack. But some variables can 
have even shorter lifespans. Inside of methods, we 
often create blocks of code. We’ve been doing this 
all along, but we haven’t explicitly talked in terms of 
blocks. Typically, blocks of code occur within methods, 
and are bounded by curly braces {}. Some common 
examples of code blocks that you’ll recognize include 
loops {for, while) and conditional expressions (like if 
statements). 
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In the previous example, y was a block variable, 
declared inside a block, and y went out of scope as 
soon as the for loop ended. Your Java programs will 
be more debuggable and expandable if you use local 
variables instead of instance variables, and block 
variables instead of local variables, whenever possible. 
The compiler will make sure that you don’t try to use 
a variable that’s gone out of scope, so you don’t have 
to worry about runtime meltdowns. 
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#6 Linked Invocations 


While you did see a little of this in this book, we tried to keep our syntax as clean and 
readable as possible. There are, however, many legal shortcuts in Java, that you’ll no doubt 
be exposed to, especially if you have to read a lot code you didn’t write. One of the more 
common constructs you will encounter is known as linked invocations. For example: 

StringBuffer sb = new StringBuffer (''spring^); 

sb = sb . delete (3, 6) . insert (2, , "umme , ") . deleteCharAt (1); 

System. out. print In (''sb = '、+ sb); 

// result is sb = summer 

What in the world is happening in the second line of code? Admittedly, this is a contrived 
example, but you need to learn how to decipher these. 

1 - Work from left to right. 

2 - Find the result of the leftmost method call, in this case sb . delete (3, 6) . If you 
look up StringBuffer in the API docs, you’ll see that the delete () method returns a 
StringBuffer object. The result of running the delete () method is a StringBuffer object 
with the value “spr”. 

3 - The next leftmost method (insert () )is called on the newly created StringBuffer 
object “spr”. The result of that method call (the insert () method), is also a StringBuffer 
object (although it doesn’t have to be the same type as the previous method return), and so 
it goes, the returned object is used to call the next method to the right. In theory, you can 
link as many methods as you want in a single statement (although it’s rare to see more than 
three linked methods in a single statement). Without linking, the second line of code from 
above would be more readable, and look something like this: 

sb = sb.delete(3,6); 
sb = sb•insert(2,"umme"); 
sb = sb.deleteCharAt(1); 

But here’s a more common, and useful example, that you saw us using, but we thought 
we’d point it out again here. This is for when your main() method needs to invoke an 
instance method of the main class, but you don’t need to keep a reference to the instance of 
the class. In other words, the main() needs to create the instance only so that main() can 
invoke one of the instance’s methods. 

class Foo { 


public static voi 
new Foo().go(); 


void main(String [] args) [ 
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Nested classes come in many flavors 

In the GUI event-handling section of the book, we started using inner (nested) classes as a 
solution for implementing listener interfaces. That’s the most common, practical, and read¬ 
able form of an inner class — where the class is simply nested within the curly braces of another 
enclosing class. And remember, it means you need an instance of the outer class in order to get 
an instance of the inner class, because the inner class is a member of the outer/enclosing class. 

But there are other kinds of inner classes including static and anonymous. We’re not going 
into the details here, but we don’t want you to be thrown by strange syntax when you see it in 
someone’s code. Because out of virtually anything you can do with the Java language, perhaps 
nothing produces more bizarre-looking code than anonymous inner classes. But we’ll start with 
something simpler — static nested classes. 

Static nested classes 

You already know what static means — something tied to the class, not a particular instance. A 
static nested class looks just like the non-static classes we used for event listeners, except they’re 
marked with the keyword static. 



void saylt() { 

System.out.println(''method of a static inner class") 




public static void main^f^tring [ ] args) {: 

FooOuter.BarInner foo = new FooOuter.BarInner() 

foo . saylt (); 


Static nested classes are more like regular non-nested classes in that they don’t enjoy a special relation¬ 
ship with an enclosing outer object. But because static nested classes are still considered a member of 
the enclosing/outer class, they still get access to any private members of the outer class... but only the 
ones that are also static. Since the static nested class isn’t connected to an instance of the outer class, it 
doesn’t have any special way to access the non-static (instance) variables and methods. 
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#5 Anonymous and Static Nested Classes, continued 


The difference between nested and inner 

Any Java class that’s defined within the scope of another class is known as a nested class. It 
doesn’t matter if it’s anonymous, static, normal, whatever. If it’s inside another class, it’s 
technically considered a nested class. But non-static nested classes are often referred to as inner 
classes, which is what we called them earlier in the book. The bottom line: all inner classes are 
nested classes, but not all nested classes are inner classes. 

Anonymous inner classes 

Imagine you’re writing some GUI code, and suddenly realize that you need an instance 
of a class that implements ActionListener. But you realize you don’t have an instance of an 
ActionListener. Then you realize that you also never wrote a class for that listener. You have two 
choices at that point: 

1) Write an inner class in your code, the way we did in our GUI code, and then instantiate it 
and pass that instance into the button’s event registration (addActionListener()) method. 

OR 


2) Create an anonymous inner class and instantiate it, right there, just-in-time. Literally right 
where you are at the point you need the listener object. That’s right, you create the class and the 
instance in the place where you’d normally be supplying just the instance. Think about that for 
a moment — it means you pass the entire class where you’d normally pass only an instance into a 
method argument! 


import j ava.awt.event.*; 
import javax•swing•*; 
public class TestAnon { 

public static void main (String[] args) 

JFrame frame = new JFrame(); 

JButton button = new JButton (''click ”） 
frame.getContentPane().add(button); 

// button.addActionListener(quitListener); 



button.addActionListener (new ActionListener() { 



public void actionPerfor: 
System.exit(0); 



(ActionEvent ev) { 
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#4 Access Levels and Access Modifiers (Who Sees What) 


Java has four access levels and three access modifiers. There are only three modifiers because 
the default (what you get when you don’t use any access modifier) is one of the four 
access levels. 


Access Levels (in order of how restrictive they are, from least to most restrictive) 


public 々 
protected 
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private 
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Access modifiers 


public 

protected 

private 


Most of the time you’ll use only public and private access levels. 

public 

Use public for classes, constants (static final variables), and methods that you’re 
exposing to other code (for example getters and setters) and most constructors. 

private 

Use private for virtually all instance variables, and for methods that you don’t want 
outside code to call (in other words, methods used by the public methods of your class). 

But although you might not use the other two (protected and default), you still need to 
know what they do because you’ll see them in other code. 
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#4 Access Levels and Access Modifiers ， cont. 

default and protected 

default 

Both protected and default access levels are tied to packages. Default access is simple — it 
means that only code within the same package can access code with default access. So a 
default class, for example (which means a class that isn’t explicitly declared as public) can 
be accessed by only classes within the same package as the default class. 

But what does it really mean to access a class? Code that does not have access to a class is 
not allowed to even think about the class. And by think, we mean use the class in code. 

For example, if you don’t have access to a class, because of access restriction, you aren’t 
allowed to instantiate the class or even declare it as a type for a variable, argument, or 
return value. You simply can’t type it into your code at all! If you do, the compiler will 
complain. 

Think about the implications — a default class with public methods means the public 
methods aren’t really public at all. You can’t access a method if you can’t see the class. 

Why would anyone want to restrict access to code within the same package? Typically, 
packages are designed as a group of classes that work together as a related set. So it might 
make sense that classes within the same package need to access one another’s code, while 
as a package, only a small number of classes and methods are exposed to the outside 
world (i.e. code outside that package). 

OK, that’s default. It’s simple — if something has default access (which, remember, means 
no explicit access modifier!), only code within the same package as the default thing 
(class, variable, method, inner class) can access that thing. 

Then what’s protected for? 


protected 

Protected access is almost identical to default access, with one exception: it allows sub¬ 
classes to inherit the protected thing, even if those subclasses are outside the package of the super¬ 
class they extend. That’s it. That’s all protected buys you — the ability to let your subclasses 
be outside your superclass package, yet still inherit pieces of the class, including methods 
and constructors. 

Many developers find very little reason to use protected, but it is used in some designs, 
and some day you might find it to be exactly what you need. One of the interesting things 
about protected is that — unlike the other access levels — protected access applies only to 
inheritance. If a subclass-outside-the-package has a reference to an instance of the superclass 
(the superclass that has, say, a protected method), the subclass can’t access the pro¬ 
tected method using that superclass reference! The only way the subclass can access that 
method is by inheriting it. In other words, the subclass-outside-the-package doesn’t have 
access to the protected method, it just has the method, through inheritance. 
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#3 String and StringBuffer/StringBuilder Methods 


Two of the most commonly used classes in the Java API are String and StringBuffer (remember from 
#9 a few pages back, Strings are immutable, so a StringBuffer/StringBuilder can be a lot mor efficient 
if you’re manipulating a String). As of Java 5.0 you should use the StringBuilder class instead of 
StringBuffer, unless your String manipulations need to be thread-safe, which is not common. Here’s a 
brief overview of the key methods in these classes: 


Both String and StringBuffer/StringBuilder classes have: 


char charAt(int index); 
int length(); 

String substring (int start, int end); 
String toString(); 

To concatenate Strings: 

String concat(string); 

String append (String); 


// what char is at a certain position 
/ / how long is this 
// get a part of this 
// what’s the String value of this 

// for the String class 
// for StringBuffer 8c StringBuilder 


The String class has: 

String replace (char old, char new); 
String substring (int begin, int end); 
char [] to Char Array (); 

String toLowerCase (); 

String toUpperCase(); 

String trim(); 

StringvalueOf(char []) 

String valueOf(int i) 


// replace all occurences of a char 
// get a portion of a String 
// convert to an array of chars 

// convert all characters to lower case 

// convert all characters to upper case 

// remove whitespace from the ends 


/ / make a String out of a char array 

// make a String out of a primitive 
// other primitives are supported as well 

The StringBuffer StringBuilder classes have: 


StringBxxxx delete (int start, int end); / / delete a portion 

StringBxxxx insert (int offset, any primitive or a char []); / / insert something 

StringBxxxx replace (int start, int end, String s); / / replace this part with this String 

StringBxxxx reverse(); // reverse the SB from front to back 

void setCharAt(int index, char ch); // replace a given character 

Note: StringBxxxx refers to either StringBuffer or StringBuilder, as appropriate. 
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#2 Multidimensional Arrays 

In most languages, if you create, say, a 4 x 2 two-dimensional array, you would visualize a 
rectangle, 4 elements by 2 elements, with a total of 8 elements. But in Java, such an array 
would actually be 5 arrays linked together! In Java, a two dimensional array is simply an array 
of arrays. (A three dimensional array is an array of arrays of arrays, but we’ll leave that for 
you to play with.) Here’s how it works 

int [ ] [] a2d = new int [4] [2]; 

The JVM creates an array with 4 elements. Each of these four elements is actually a reference 
variable referring to a (newly created), int array with 2 elements. 
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Working with multidimensional arrays 


- To access the second element in the third array: int x = a2d[2] [1] ; // remember, 0 based! 

- To make a one-dimensional reference to one of the sub-arrays: int [ ] copy = a2d [ 1 ] ; 

- Short-cut initialization of a 2 x 3 array: int [] [] x = { { 2,3,4 }, { 7,8,9 } }; 

- To make a 2d array with irregular dimensions: 

int[][] y = new int [2][]; // makes only the first array, with a length of 2 

y[0] = new int [3]; // makes the first sub-array 3 elements in length 

y[1] = new int [5]; // makes the second sub-array 5 elements in length 
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And the number one topic that didn’t quite make it in... 

#1 Enumerations (also called Enumerated Types or Enums) 


We’ve talked about constants that are defined in the API, for instance, 

JFrame.EXIT_ON_CLOSE . You can also create your own constants by 
marking a variable static final. But sometimes you’ll want to create a set 
of constant values to represent the only valid values for a variable. This set of 
valid values is commonly referred to as an enumeration. Before Java 5.0 you 
could only do a half-baked job of creating an enumeration in Java. As of Java 
5.0 you can create full fledged enumerations that will be the envy of all your 
pre-Java 5.0-using friends. 

Who’s in the band? 

Let’s say that you’re creating a website for your favorite band, and you want to 
make sure that all of the comments are directed to a particular band member. 

The old way to fake an “enum ”： 

public static final int JERRY = 1 ; 
public static final int BOBBY = 2; 
public static final int PHIL = 3; 


// later in the code 


hoping that by the time wc 

has a valid value/ 



if (selectedBandMember == JERRY) 


// do JERRY related stuff 


The good news about this technique is that it DOES make the code easier to 
read. The other good news is that you can’t ever change the value of the fake 
enums you’ve created; JERRY will always be 1. The bad news is that there’s 
no easy or good way to make sure that the value of selectedBandMember 
will always be 1 , 2, or 3. If some hard to find piece of code sets 
selectedBandMember equal to 812, it’s pretty likely your code will break... 
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#1 Enumerations ， cont. 


The same situation using a genuine Java 5.0 enum. While this is a very basic 
enumeration, most enumerations usually are this simple. 


A new, official “enum ”： 

public enum Members { JERRY, BOBBY, PHIL 
public Members selectedBandMember; 

// later in the code 

if (selectedBandMember == Members.JERRY) 
// do JERRY related stuff 




AoCS “ 」 cAa 沾加 e L 丨 

T"he sclcdtcdBahdA1ci^bcv- w variable is type 
U /Wcn,bc\rs^ ahd OMLY have a value <^P 

WBr, or “PHIL” 


Wo 咐 d to woinry about this variables value/ 


The syntax to io ^ 


Your enum extends java.Iang.Enum 

When you create an enum, you’re creating a new class, and you^re implicitly extending 
java . lang. Enum. You can declare an enum as its own standalone class, in its own 
source file, or as a member of another class. 


Using “if” and “switch” with Enums 

Using the enum we just created, we can perform branches in our code using either 
the if or switch statement. Also notice that we can compare enum instances using 
either == or the . equals () method. Usually == is considered better style. 


⑼ um vdl^C *to B vavi^blc* 

Members n = Members.BOBBY; 

if (n . equals (Members . JERRY) ) System. out. print In (''Jerrrry \ ,r ); 


if (n 


Members . BOBBY) System. out. print In (''Rat Dog 〃）； 


Members ifName = Members.PHIL; 
switch (ifName) { 

case JERRY : System. out .print (''make it sing v 
case PHIL: System. out.print (''go deep、'); 
case BOBBY : System. out. print In (''Cassidy ! 〃）； 

} 


灿 P〆 〜 


NJOVV- 






Pop ^uiz./ iVhal s -the output? 
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appendix B Top Ten Reference 


#1 Enumerations, completed 


A really tricked-out version of a similar enum 

You can add a bunch of things to your enum like a constructor, methods, 
variables, and something called a constant-specific class body. They’re 
not common, but you might run into them: 


public class HfjEnum 


、山 ass 


… 七 0 


enum Names { 

JERRY (''lead guitar^) { public String sings () { 

return ''plaintively"; } 

BOBBY (''rhythm guitar ’’） { public String sings () { 

return ''hoarsely 


T\\tst av-c so - tailed 







PHIL (''bass") 


TWrnk as 

feas “_ .etW U tV>is cast 

如 、•”()” ^W)，4 ' s 

.ailed o, a 呼 = ， 
value 观 Y 


private String instrument; 

Names (String instrument) { 

this.instrument = instrument 

} 

public String getlnstrument() 
return this.instrument; 


public String sings() { 

return ''occasionally 

} 


This is {\\t 伙 uw/s 6 cms*brud*to\r. I 七 runs 
or\tt (or dcdlavcd ⑶ u 州 value (\v\ 

-this dasc i-t VUirvS tn^cs). 


rr 


/ou’ll see -these r^c-thods bcihg called -fvor^ “ 州 aihO" 


public static void main(String [] args) { 

for (Names n : Names.values()) { 

System.out.print(n); 

System. out. print ('', instrument : '、+ n • get Instrument ()); 
System. out. print In ('\ sings : '、+ n . sings ()); 



ervuw Corots 叫必 a 

wa 七 -… w * s0 ”』 od 

^ 6dll V U$Cd m 3 

w jfo/ loo\> as sho 鲁 


I File Edit Window Help Bootleg | 


% java HfjEnum 

JERRY, instrument: lead guitar, sings: plaintively 
BOBBY, instrument: rhythm guitar, sings: hoarsely 
PHIL, instrument: bass, sings: occasionally 

% 


l^ohu that ii)C bdsid w smgO w 
method is ohly called wheh the 
ChUr»\ v^luc ho dohS*t3h*t— 


spedi-fid dldss body. 
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Five 趙 
鄭 ㈣ 


A Long Trip Home 



Captain Byte of the Flatland starship “Traverser” had received an urgent, Top Secret transmission 
from headquarters. The message contained 30 heavily encrypted navigational codes that the 
Traverser would need to successfully plot a course home through enemy sectors. The enemy 
Hackarians, from a neighboring galaxy, had devised a devilish code-scrambling ray that was capable 
of creating bogus objects on the heap of the Traverser’s only navigational computer. In 
addition, the alien ray could alter valid reference variables so that they referred to these 
bogus objects. The only defense the Traverser crew had against this evil Hackarian ray was 
to run an inline vims checker which could be imbedded into the Traverser’s state of the art 
Java 1.4 code. 

Captain Byte gave Ensign Smith the following programming instructions to process the critical 
navigational codes: 


“Put the first five codes in an array of type ParsecKey. Put the last 25 codes in a five by five, two 
dimensional array of type QuadrantKey. Pass these two arrays into the plotCourse() method of the 
public final class ShipNavigation. Once the course object is returned run the inline vims checker 
against all the programs reference variables and then run the NavSim program and bring me the 
results.” 


A few minutes later Ensign Smith returned with the NavSim output. “NavSim output ready for 
review, sir”, declared Ensign Smith. “Fine”, replied the Captain, “Please review your work”. “Yes 
sir!”，responded the Ensign, “First I declared and constructed an array of type ParsecKey with the 
following code; ParsecKey [] p = new ParsecKey[5]; , next I declared and constructed an array 
of type QuadrantKey with the following code: QuadrantKey [] [] q = new QuadrantKey [5] [5];. 
Next, I loaded the first 5 codes into the ParsecKey array using a ‘for’ loop, and then I loaded the last 
25 codes into the QuadrantKey array using nested ‘for’ loops. Next, I ran the vims checker against 
all 32 reference variables, 1 for the ParsecKey array, and 5 for its elements, 1 for the QuadrantKey 
array, and 25 for its elements. Once the vims check returned with no viruses detected, I ran the 
NavSim program and re-ran the vims checker, just to be safe... Sir ! “ 

Captain Byte gave the Ensign a cool, long stare and said calmly, “Ensign, you are confined to 
quarters for endangering the safety of this ship, I don’t want to see your face on this bridge again 
until you have properly learned your Java! Lieutenant Boolean, take over for the Ensign and do this 
job correctly!” 


Why did the captain confine the Ensign to his quarters? 
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A Long Trip Home 

Captain Byte knew that in Java, multidimensional arrays are actu¬ 
ally arrays of arrays. The five by five QuadrantKey array ‘q’，would 
actually need a total of 31 reference variables to be able to access 
all of its components: 


1 - reference variable for 
5 - reference variables for q[0] - q[4] 

25 - reference variables for q[0] [0] - q[4] [4] 


The ensign had forgotten the reference variables for the five one 
dimensional arrays embedded in the ‘q’ array. Any of those five 
reference variables could have been corrupted by the Hackarian 
ray, and the ensign’s test would never reveal the problem. 
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Symbols 

Sc, 8c8c, |. || (boolean operators) 151, 660 
Sc, «, 〉〉， »>, 八 ， I, 〜 (bitwise operators) 660 
++ - (increment/decrement) 105, 115 
+ (String concatenation operator) 17 

.(dot operator) 36 
reference 54 

<, <=，==，!=，〉，〉= (comparison operators) 86, 114, 
151 

(comparison operators) 11 

A 

abandoned objects. See garbage collection 

abstract 

class 200-210 
class modifier 200 

abstract methods 
declaring 203 
access 

and inheritance 180 
class modifiers 667 
method modifiers 81, 667 
variable modifiers 81， 667 

accessors and mutators. See getters and setters 

ActionListener interface 358, 358-361 

addActionListener() 359-361 

advice guy 480, 484 

Aeron™ 28 

animation 382-385 

API 154-155, 158-160 
ArrayList 532 
collections 558 


appendix A 649-658 

beat box final client 650 
beat box final server 657 

appendix B 

access levels and modifiers 667 

assertions 662 

bit manipulation 660 

block scope 663 

immutability 661 

linked invocations 664 

multidimensional arrays 670 

String and StringBuffer methods 669 

apples and oranges 137 

arguments 

method 74, 76, 78 
polymorphic 187 

ArrayList 132, 133-138, 156, 208, 558 
API 532 

ArrayList<Obj ect> 211-213 
autoboxing 288-289 
casting 229 

arrays 

about 17, 59, 135 
assigning 59 

compared to ArrayList 134-137 
creation 60 
declaring 59 
length attribute 17 
multidimensional 670 
objects, of 60, 83 
primitives, of 59 

assertions 

assertions 662 
assignments, primitive 52 
assignments, reference variables 55, 57, 83 
atomic code blocks 510-512. See also threads 
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audio. See midi 

autoboxing 288-291 
and operators 291 
assignments 291 

B 

bark different 73 
bathtub 177 

beat box 316, 347, 472. See also appendix A 

beer 14 

behavior 73 

Bela Fleck 30 

bitwise operators 660 

bit shifting 660 

block scope 663 

boolean 51 

boolean expressions 11， 114 
logical 151 

BorderLayout manager 370-371 ， 401, 407 

BoxLayout manager 411 

brain barbell 33, 167, 188 

break statement 105 

BufferedReader 454, 478 

BufferedWriter 453 

buffers 453, 454 

byte 51 

bytecode 2 

c 

Calendar 303-305 
methods 305 
casting 

explicit primitive 117 
explicit reference 216 
implicit primitive 117 

catching exceptions 326 
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catch 338 

catching multiple exceptions 329, 330, 332 
try 321 

catch blocks 326, 338 

catching multiple exceptions 329, 330, 332 
chair wars 28, 166 
char 51 

chat client 486 
with threads 518 
chat server (simple) 520 

checked exceptions 
runtime vs. 324 

checking account. See Ryan and Monica 

check box (JCheckBox) 416 

class 

abstract 200-210 
concrete 200-210 
designing 34, 41, 79 
final 283 

fully qualified names 154-155, 157 
client/server 473 
code kitchen 

beat box save and restore 462 
final beat box. See appendix A 
making the GUI 418 
music with graphics 386 
playing sound 339 

coffee cups 51 

collections 137, 533 
API 558 
ArrayList 137 
ArrayList<Object> 211-213 
Collections.sort() 534, 539 
HashMap 533 
HashSet 533 
LinkedHashMap 533 
LinkedList 533 
List 557 
Map 557, 567 
parameterized types 137 
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Set 557 
TreeSet 533 

Collections.sort() 534, 539 
Comparator 551 
compare () 553 

Comparable 547, 566 
and TreeSet 566 
compareTo() method 549 

Comparator 551， 566 
and TreeSet 566 
compare () 553 
compare To () 549 
comparing with == 86 

compiler 2 
about 18 
java -d 590 

concatenate 17 
concrete classes 200-210 
conditional expressions 10, 11， 13 
constants 282 

constructors 
about 240 
chaining 250-256 
overloaded 256 
superclass 250-256 

contracts 190-191, 218 

cups 51 

curly braces 10 

D 

daily advice client 480 
daily advice server 484 
dancing girl 316 
dates 

Calendar 303 
methods 305 
formatting 301 
GregorianCalendar 303 


java.util.Date 303 
deadlock 516 

deadly diamond of death 223 

declarations 
about 50 

exceptions 335-336 
instance variables 50 

default access 668 

default value 84 

deployment options 582, 608 

deserialized objects 441. See also serialization 

directory structures 
packages 589 
servlets 626 

doctor 169 

dot operator 
reference 54 
double 51 

duck 277 

construct 242 
garbage collect 261 

ducking exceptions 335 

E 

EJB 631 

encapsulation 
about 79-82 
benefits 80 

end of book 648 
enumerations 671-672 
enums 671-672 

equality 560 

and hashCode() 561 
equals () 561 

equals () 
about 209 
Object class 209 
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event handling 357-361 
event object 361 
listener interface 358-361 
using inner classes 379 

event source 359-361 

exceptions 

about 320, 325, 338 
catch 321, 338 

catching multiple exceptions 329, 332 

checked vs. runtime 324 

declaring 335-336 

ducking 335-336 

finally 327 

flow control 326 

handle or declare law 337 

propagating 335-336 

remote exceptions 616 

throwing 323-326 

try 321, 338 

executable JAR 585-586, 586 
with packages 592, 592-593 
exercises 

be the …88, 118, 266, 310, 395 
code magnets 20, 43, 64, 119, 312, 349, 467, 
524-525 
honeypot 267 

true or false 311 ， 348, 466, 602 
what’s the declaration 231 
what’s the picture 230 
which layout manager? 424 
who am I 45, 89, 394 

Extreme Programming 101 

F 

File 452 

FilelnputStream 441. See also I/O 
FileOutputStream 432 
FileReader 454. See also 1/O 
files 

File class 452 


reading from 441, 454 
source file structure 7 
writing to 432, 447 

FileWriter 447 
File class 452 
final 

class 189, 283 
methods 189, 283 
static variables 282 
variables 282, 283 

finally block 327 

fireside chats 
about 18 

five minute mystery. See puzzles 
float 51 

FlowLayout 403, 408-410 

flow control 

exceptions 326 
font 406 

formatting 

dates 301-302 
format specifiers 295-296 
argument 300 
numbers 294-295 
printf() 294 
String.format() 294 

for loops 105 

fully qualified name 154, 157 
packages 587 

G 

garbage collection 
about 40 

eligible objects 260-263 
heap 57, 58 
nulling references 58 
reassigning references 58 

generics 540, 542, 568-574 
methods 544 
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wildcards 574 
getters and setters 79 
ghost town 109 
giraffe 50 

girl dreaming 

inner classes 375 
Java Web Start 596 

girl in a tub 177 

girl who isn’t getting it 182-188 

graphics 364-366. See also GUI 
Graphics2D class 366 
Graphics object 364 

GregorianCalendar 303 
guessing game 38 

GUI 406 

about 354, 400 
animation 382-385 
BorderLayout 370-371, 401， 407 
box layout 403, 411 
buttons 405 

components 354, 363-368, 400 

event handling 357-361, 379 

flow layout 403, 408 

frames 400 

graphics 363-367 

Imagelcon class 365 

JButton 400 

JLabel 400 

JPanel 400, 401 

JTextArea 414 

JTextField 413 

layout managers 401-412 

listener interface 358-361 

scrolling (JScrollPane) 414 

Swing 354 

GUI Constants 

ScrollPaneConstants.HORIZONTAL_SCROLL- 
BAR_NEVER 415 

ScrollPaneConstants.VERTICAL_SCROLLBAR_ 
ALWAYS 415 


drawlmage () 365 
fillOvalO 365 
fillRectO 364 

gradientPaint(). See also GUI 
paintComponent () 364 
setColor() 364 
setFont() 406 

GUI Widgets 354 
JButton 354, 405 
JCheckBox 416 
JFrame 354, 400, 401 
JList 417 
JPanel 400, 401 
JScrollPane 414, 417 
JTextArea 414 
JTextField 413 

H 

HAS-A 177-181 
hashCode() 561 
HashMap 533, 558 
HashSet 533, 558 
Hashtable 558 
heap 

about 40, 57, 236-238 
garbage collection 40, 57, 58 


I/O 

BufferedReader 454, 478 

BufferedWriter 453 

buffers 453 

deserialization 441 

FilelnputStream 441 

FileOutputStream 432 

FileWriter 447 

InputStreamReader 478 

Obj ectlnputStream 441 

ObjectOutputStream 432, 437 

serialization 432, 434-439, 437, 446, 460 


GUI methods 
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streams 433, 437 
with sockets 478 

if-else 13 
if statement 13 

immutability, Strings 
immutability 661 
implements 224 
imports 

static imports 307 
import statement 155, 157 
increment 105 

inheritance 

about 31, 166-192 
and abstract classes 201 
animals 170-175 
IS-A 214, 251 
super 228 

initializing 

instance variables 84 
primitives 84 
static variables 281 

inner classes 

about 376-386 
events 379 

inner class threesome 381 
InputStreamReader 478 

instance variables 
about 34, 73 
declaring 84 
default values 84 
initializing 84 
life and scope 258-263 
local variables vs. 236-238, 239 
static vs. 277 

instantiation. See objects 

int 50 

primitive 51 
Integer. See wrapper 
interfaces 


about 219-227 
for serialization 437 
implementing 224, 437 
implementing multiple 226 
java.io.Serializable 437 

IP address. See networking 
IS-A 177-181, 251 



J2EE 631 
JAR files 

basic commands 593 
executable 585-586, 592 
manifest 585 

running executable 586, 592 
tool 593 

with Java Web Start 598 
Java, about 5, 6 
javac. See compiler 
Java in a Nutshell 158-159 
java sound 317, 340 

Java Web Start 597-601 
jnlp file 598, 599 
Jini 632-635 

JNLP 598 
jnlp file 599 
JPEG 365 



about 2, 18 

JWS. Java Web Start 

K 

keywords 53 



1 264 


layout managers 401-412 

BorderLayout 370-371 ， 403, 407 
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BoxLayout 403, 411 
FlowLayout 403, 408-410 

lingerie, exceptions 329 
LinkedHashMap 533, 558 
LinkedHashSet 558 
LinkedList 533, 558 
linked invocations 664 
List 557 
listeners 

listener interface 358-361 
literals, assigning values 
primitive 52 
local 

variables 85, 236, 236-238, 258-263 
locks 

object 509 
threads 509 

long 51 

loops 

about 10 
break 105 
for 105 
while 115 

lost update problem. See threads 

M 

main() 9, 38 

make it stick 53, 87, 157, 179, 227, 278 
manifest file 585 
Map 557, 567 
Math class 

methods 274-278, 286 
random() 111 

memory 

garbage collection 260-263 
metacognitive tip 33, 108, 325 

methods 

about 34, 78 


abstract 203 
arguments 74, 76, 78 
final 283 

generic arguments 544 
on the stack 237 
overloading 191 
overriding 32, 167-192 
return 75, 78 
static 274-278 

midi 317, 340-346, 387-390 
midi sequencer 340-346 
MINI Cooper 504 

modifiers 
class 200 
method 203 

multidimensional arrays 670 
multiple inheritance 223 
multiple threads. See threads 
music. See midi 
mystery. See puzzles 

N 

naming 53. See also RMI 

classes and interfaces 154-155, 157 
collisions 587 
packages 587 

networking 
about 473 
ports 475 
sockets 475 

new 55 

null 

reference 262 
numbers 

formatting 294-295 

0 

ObjectOutputStream 432, 437 
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objects 

about 55 

arrays 59, 60, 83 

comparing 209 

creation 55, 240-256 

eligible for garbage collection 260-263 

equality 560 

equals () 209, 561 

life 258-263 

locks 509 

Object class 

about 208-216 
equals () 561 
hashCode() 561 
overriding methods 563 

object graph 436, 438 

object references 54, 56 
assignment 55, 262 
casting 216 
comparing 86 
equality 560 
nulling 262 

polymorphism 185-186 

OO 

contracts 190-191, 218 
deadly diamond of death 223 
design 34, 41 ， 79, 166-191 
HAS-A 177-181 
inheritance 166-192 
interfaces 219-227 
IS-A 177-181，251 
overload 191 
override 167-192 

polymorphism 183, 183-191, 206-217 
superclass 251-256 

operators 

and autoboxing 291 
bitwise 660 
comparison 151 
conditional 11 
decrement 115 


increment 105, 115 
logical 151 
shift 660 

overload 191 

constructors 256 
override 

about 32, 167-192 
polymorphism. See polymorphism 

P 

packages 154-155, 157, 587-593 
directory structure 589 
organizing code 589 

paintComponent () 364-368 
parameter. See arguments 
parameterized types 137 
parsing an int. See wrapper 
parsing text with String.split() 458 
pass-by-copy. See pass-by-value 
pass-by-value 77 
phrase-o-matic 16 

polymorphism 183-191 
abstract classes 206-217 
and exceptions 330 
arguments and return types 187 
references of type Object 211-213 

pool puzzle. See puzzles 

ports 475 

prep code 99-102 

primitives 53 
== operator 86 
autoboxing 288-289 
boolean 51 
byte 51 
char 51 
double 51 
float 51 
int 51 
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ranges 51 
short 51 
type 51 

primitive casting 

explicit primitive 117 
printf() 294 
PrintWriter 479 
private 

access modifier 81 
protected 668 
public 

access modifier 81， 668 
puzzles 

five minute mystery 92, 527, 674 
Java cross 22, 120, 162, 350, 426, 603 
pool puzzle 24, 44, 65, 91, 194, 232, 396 

quiz card builder 448, 448-451 

R 

rabbit 50 
random() 111 

ready-bake code 112, 152-153, 520 

reference variables. See object references 
casting 216 

registry, RMI 615, 617, 620 
remote control 54, 57 
remote interface. See RMI 
reserved words 53 

return types 
about 75 
polymorphic 187 
values 78 

risky code 319-336 

RMI 

about 614-622 
client 620, 622 


compiler 618 

Jini. See also ]ini 

Naming.lookupO 620 

Naming, rebind (). See also RMI 

registry 615, 617, 620 

remote exceptions 616 

remote implementation 615, 617 

remote inteface 615, 616 

rmic 618 

skeleton 618 

stub 618 

UnicastRemoteObject 617 
universal service browser 636-648 

rmic. See RMI 

run() 

overriding in Runnable interface 494 
Runnable interface 492 
about 493 
run() 493, 494 
threads 493 

runnable thread state 495 

Ryan and Monica 505-506 
introduction 505-506 



scary objects 200 

scheduling threads 
scheduling 496-498 
scope 

variables 236-238, 258-263 
scrolling (JScrollPane) 414 

serialization 434-439, 446 
deserialization 460 
interface 437 

ObjectlnputStream. See 1/O 
objectOutputStream 432 
objects 460 
object graph 436 
reading. See 1/O 
restoring 460. See also 1/O 
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saving 432 

serialVersionUID 461 
transient 439 
versioning 460, 461 
writing 432 

server 

socket 483. See also socket 
servlet 625-627 
Set 557 

importance of equals () 561 
importance of hashCode () 561 

short 51 

short circuit logical operators 151 
sink a dot com 96-112, 139-150 
skeleton. See RMI 
sleep () 501-503 
sleeping threads 501-503 
snowboard 214 

socket 

about 475 
addresses 475 
creating 478 
I/O 478 
ports 475 
reading from 478 
server 483 
TCP/IP 475 
writing to 479 

sorting 

Collections.sort() 534, 539, 547 
Comparable interface 547, 549 
Comparator 551, 553 
TreeSet 564-566 

source files 

structure of 7 
specifiers 

format specifiers 295, 298 
argument specifier 300 
stack 

heap vs. 236 


methods on 237 
scope 236 
threads 490 
trace 323 

static 

enumerated types 671 
initializer 282 

Math class methods 274-278 
methods 274-278 
static imports 307 
variables 282 

streams 433. See also 1/O 

String 

arrays 17 
concatenating 17 
methods 669 
parsing 458 

String.format() 294-297 
String.split() 458 

StringBuffer/StringBuilder 
methods 669 
stub. See RMI 
subclass 

about 31,166-192 
super 228 
about 31 
superclass 

about 166-192, 214-217,228 
super constructor 250-256 
Swing. See GUI 
synchronized 

methods 510. See also threads 
syntax 

about 10, 12 
System.out.print() 13 
System. out.println() 13 
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T 

talking head 203 
TCP ports 475 
Telluride 30 
testing 

extreme programming 101 
text 

parsing with String.split () 458 458 
read from a file. See also 1/O 
write to a file 447 

text area (JTextArea) 414 

text field (JTextField) 413 

Thread.sleepO 501-503 

threads 

about 489-515 
deadlock 516 
locks 509 

lost update problem 512-514 

run() 493, 494 

Runnable 492, 493, 494 

Ryan and Monica problem 505-507 

scheduling 496, 496-498 

sleep () 501-503 

stack 490-491 

start () 492 

starting 492 

states 495, 496 

summary 500, 517 

synchronized 510-512 

unpredictability 498-499 

throw 

exceptions 323-326 
throws 323-326 

transient 439 
Tree Map 558 

TreeSet 533, 558, 564-566, 566 
try 

blocks 321, 326 


type 50 

parameter 137, 542, 544 
type-safety 540 
and generics 540 

u 

universal service browser 636-648 

V 

variables 

assigning 52, 262 

declaring 50, 54, 84, 236-238 

local 85, 236-238 

nulling 262 

primitive 51, 52 

references 54, 55, 56, 185-186 

scope 236-238 

static. See static 

variable declarations 50 
instance 84 
primitive 51 
reference 54 

virtual method invocation 175 

¥ 

web start. Java Web Start 
while loops 11, 115 
wildcard 574 
wine 202 

wrapper 287 

autoboxing 288-289 
conversion utilities 292 
Integer.parselnt () 104, 106, 117 

writing. See 1/O 
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Don’t you know about the web site? 
Weve got answers to some of the 
Sharpens, examples, the Code Kitchens, 
Ready-bake Code, and daily updates 
from the Head First author blogs! 


This isrft goodbye 
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